PlayFab Party 錯誤碼 - XBOX Game Development Documentation

PlayFab Party API 使用下列錯誤碼：

一般錯誤

十六進位	十進位	描述
0x0001	1	發生未知錯誤。
0x0002	2	無法配置記憶體。
0x0003	3	API 未實作。
0x0004	4	指定的引數無效。
0x0005	5	無法建立新的執行緒。
0x0006	6	找不到指定的資源。
0x0007	7	作業正在擱置中。
0x0008	8	未對應的平台錯誤。
0x0009	9	未對應的訊息錯誤。
0x000A	10	傳遞的緩衝區太小。
0x000B	11	元件處於無效狀態，無法執行要求的作業。
0x000C	12	無法啟動以暫停狀態建立的執行緒。
0x0018	24	指定的 PlayFab 實體識別碼無效。
0x0020	32	PlayFab 權杖太大。
0x0022	34	尚未將指定的 PlayFab 實體識別碼提供給 Party 程式庫。
0x0023	35	PlayFab 實體權杖格式不正確或因其他原因無效。
0x0024	36	使用者未獲授權執行此作業。
0x0026	38	必須提供至少一個至少包含一個位元組的資料緩衝區。
0x0029	41	指定的引數有效，但尚未實作支援。
0x002C	44	驗證 PlayFab 實體權杖時發生錯誤。
0x002D	45	提供的網路設定結構無效。
0x002E	46	提供的邀請未指定識別碼。
0x002F	47	提供的邀請指定了太多實體識別碼。
0x0030	48	提供之邀請的識別碼太長。
0x0031	49	提供之邀請的可撤銷性無效。
0x0032	50	網路中已存在具有所提供識別碼的另一個邀請。
0x0036	54	此作業已在進行中。
0x0039	57	提供給網路傳輸的緩衝區不足。
0x003A	58	網路介面尚未就緒。
0x003B	59	網路介面已失敗。
0x003C	60	無法繫結或連線 UDP 通訊端，因為位址已在本機使用中。
0x003D	61	因達到系統限制而無法完成作業。
0x003E	62	網路傳輸無法完成作業，因為相關聯的資料太大。
0x003F	63	無法建立或維持與網路或遠端對等端的連線。
0x0040	64	遠端拒絕了傳入的連線。
0x0044	68	封包在傳輸線路上遺失。
0x0045	69	收到包含格式不正確資料的封包。
0x0046	70	提供給網路傳輸的控制代碼重複。
0x0048	72	網路傳輸通道已終止。
0x0049	73	網路傳輸連結已被遠端終止。
0x004A	74	網路傳輸連結已在本機終止。
0x004B	75	網路傳輸主機名稱無效或無法解析。
0x004C	76	遠端強制關閉了通訊端。
0x004E	78	網路傳輸作業逾時。
0x0051	81	無法建立網路傳輸連結，因為已存在連至該遠端位址的連結。
0x0052	82	嘗試建立安全連線時逾時。
0x0053	83	對 PlayFab 服務的要求逾時。
0x0054	84	處理服務要求時發生內部錯誤。
0x0055	85	HTTP 連線已重設或終止。
0x0056	86	HTTP 作業意外取消。
0x0057	87	HTTP 回應比預期小。
0x0058	88	HTTP 回應比預期大。
0x005B	91	平台作業提供了一般失敗碼。
0x005C	92	PlayFab 實體權杖已過期。
0x005D	93	HTTP 要求已被服務節流。
0x0069	105	HTTP 要求因憑證無效而失敗。
0x006D	109	目標裝置不在網路中。
0x006F	111	無法完成作業，因為必要的 DTLS 交握狀態已過期或遺失。
0x0070	112	尚未設定連結的遠端位址。
0x0071	113	此平台不支援網路傳輸作業。
0x0072	114	遇到無效的平台類型。
0x0073	115	無法將字串轉換為 UUID。
0x0077	119	即使重試後，也未產生任何網路傳輸 DTLS 交握資料位元組。
0x0078	120	本機網路傳輸裝置未啟用必要的安全傳輸。
0x0079	121	遠端網路傳輸位址所描述的裝置未啟用必要的安全傳輸。
0x007D	125	網路傳輸的可能目標未產生 DTLS 交握資料位元組。
0x007F	127	執行網路傳輸摘要作業失敗。
0x0082	130	網路傳輸需要連接埠號碼，但缺少此號碼。
0x0083	131	網路傳輸沒有可用的本機網路位址。
0x0085	133	PlayFab 服務偵測到並行的衝突變更，無法完成作業。此錯誤最常見的原因是多個用戶端以相同的 PlayFab 實體呼叫相同的 PlayFab API。
0x0089	137	禁止在 Party 初始化之後設定工作模式。
0x008D	141	無法在目前的工作模式下執行作業。
0x008E	142	無法執行作業，因為它不是從 COM 多執行緒 Apartment 中的執行緒叫用的。
0x008F	143	此遊戲未啟用文字仲裁服務；請連絡 Microsoft 以啟用。
0x0090	144	服務執行文字仲裁時發生錯誤。
0x0093	147	不支援在直接對等連線上仲裁文字聊天。
0x0095	149	禁止在 Party 初始化之後設定剖析回呼。
0x009E	158	網路傳輸作業所需的資源目前忙碌中。
0x00A0	160	HTTP 要求因伺服器所傳送的 SSL 憑證發生錯誤而失敗。
0x00A1	161	無法解析網路傳輸主機名稱。
0x00A2	162	網路傳輸主機名稱沒有任何相關聯的 IP 位址。
0x00A3	163	解析網路傳輸主機名稱未傳回任何結果。
0x00A9	169	作業因 URL 無效而失敗。
0x00AC	172	系統拒絕了繫結 UDP 通訊端或其他網路傳輸作業的存取權限。
0x00B9	185	實體類型不是目前支援的類型之一。

用戶端錯誤

十六進位	十進位	描述
0x1000	4096	必須初始化 Party 程式庫。
0x1001	4097	已有使用者與指定的聊天控制項相關聯。
0x1002	4098	以無效的控制代碼呼叫了作業。
0x1003	4099	無法建立本機使用者；已達到本機使用者上限。
0x1004	4100	無法建立本機使用者；本機使用者已存在。
0x1005	4101	一次只能存在一個 PartyManager 執行個體。
0x1006	4102	無法連線到網路；網路已連線。
0x1007	4103	發生網際網路連線錯誤。
0x1008	4104	無法執行作業，因為物件正在終結。
0x1009	4105	無法建立另一個聊天控制項；已達到聊天控制項上限。
0x100C	4108	執行緒親和性遮罩要求的處理器未在處理程序親和性遮罩中選取。
0x100E	4110	端點的相關資訊尚無法取得，因為端點仍在建立中。
0x1010	4112	建立網路的要求失敗，因為沒有可用的伺服器。
0x1011	4113	無法存取音訊裝置。
0x1012	4114	音訊作業失敗，因為提供了不支援的音訊格式。
0x1013	4115	裝置控制代碼必須參考本機裝置。
0x1014	4116	聊天控制項控制代碼必須參考本機聊天控制項。
0x1015	4117	端點控制代碼必須參考本機端點。
0x1016	4118	指定的音訊輸出正在等候初始化。
0x1017	4119	已識別指定的音訊輸出，但已停用。
0x1018	4120	已識別指定的音訊輸出，但不存在。
0x1019	4121	已識別指定的音訊輸出，但目前已拔除。
0x101A	4122	配置服務無法使用。
0x101B	4123	為傳送訊息提供的資料緩衝區太多。
0x1022	4130	用戶端找不到指定的端點識別碼。
0x1023	4131	指定的端點識別碼無效或超出範圍。
0x1025	4133	無法建立端點，因為已達到網路設定所指定的上限。
0x102C	4140	端點清單尚無法取得。
0x102F	4143	不支援使用本機目標聊天控制項。
0x1031	4145	為傳送訊息指定的目標端點太多。
0x1034	4148	提供的網路控制代碼不擁有所提供的端點控制代碼。
0x103E	4158	用戶端無法解析網路的 IP 位址和連接埠字串。
0x103F	4159	多人遊戲伺服器回應指定了非預期的 Azure 區域。
0x1040	4160	嘗試以未驗證的本機使用者建立端點或連線聊天控制項。
0x1042	4162	此版本的 Party 程式庫不支援序列化的網路描述元。
0x1043	4163	網路識別碼無效。
0x1044	4164	區域名稱無效。
0x1045	4165	網路描述元的不透明連線資訊無效。
0x1046	4166	序列化網路描述元字串的大小太小，無法還原序列化為有效資料。
0x1049	4169	聊天控制項已在指定的網路中。
0x104A	4170	聊天控制項不在指定的網路中。
0x104B	4171	此版本的 Party 程式庫不支援不透明連線資訊。
0x104C	4172	網路描述元之不透明連線資訊中包含的主機名稱無效。
0x104D	4173	網路描述元之不透明連線資訊中包含的連接埠無效。
0x104E	4174	網路設定尚無法取得。
0x104F	4175	音訊轉譯音量超出允許的範圍 [0.0, 1.0]。
0x1051	4177	嘗試代表未驗證的本機使用者執行邀請作業。
0x1058	4184	提供的目標聊天控制項清單包含至少一個重複的聊天控制項。
0x1059	4185	提供的目標端點清單包含至少一個重複的端點。
0x105A	4186	平台錯誤導致無法判斷慣用的 UI 語言。
0x105E	4190	嘗試驗證已驗證的使用者。
0x1062	4194	文字轉語音合成要求因太大而被服務拒絕。
0x1063	4195	文字轉語音合成要求已被節流。
0x1064	4196	文字轉語音合成要求未獲授權。
0x1065	4197	文字轉語音合成要求已取消。
0x1066	4198	提供的文字轉語音合成字串超過文字轉語音合成字串長度上限。
0x1069	4201	剖析轉譯片語文字失敗。
0x106A	4202	無法判斷區域清單。
0x106B	4203	此版本的 Party 程式庫與 PlayFab 服務不相容。
0x106C	4204	配置要求傳回的主機名稱無效。
0x106D	4205	傳送訊息佇列優先順序不在允許的範圍內。
0x1071	4209	對服務品質信標的 Ping 逾時。
0x1072	4210	找不到支援的區域。
0x1073	4211	提供給 PlayFab 服務的要求格式不正確。
0x1074	4212	遊戲未獲授權執行此作業。
0x1075	4213	嘗試傳送至本機目標；尚不支援回送。
0x1079	4217	指定的文字轉語音設定檔無效。
0x107A	4218	嘗試在未設定文字轉語音設定檔的情況下合成文字。
0x107B	4219	無法識別提供的性別。
0x107C	4220	遠端轉譯作業失敗。
0x107D	4221	收到無效的轉譯錯誤類型。
0x107E	4222	指定的文字轉語音設定檔識別碼太長。
0x107F	4223	指定的文字轉語音設定檔名稱太長。
0x1080	4224	指定的語言代碼太長。
0x1081	4225	PlayFab 服務已節流此使用者的要求。
0x1082	4226	PlayFab 服務已節流此遊戲的要求。
0x1083	4227	剖析轉譯假設文字失敗。
0x1084	4228	要求的統計資料清單包含至少一個重複的統計資料類型。
0x1085	4229	要求的統計資料清單包含無法識別或不支援的統計資料類型。
0x1086	4230	此遊戲未啟用 PlayFab Party。請檢查 PlayFab Game Manager 入口網站。
0x1087	4231	填入文字轉語音設定檔的要求已取消。
0x1089	4233	服務提供了無效的翻譯回應。
0x108A	4234	網路的設定不允許再有更多唯一使用者。
0x108B	4235	網路的設定不允許此裝置上再有更多使用者。
0x108C	4236	網路的設定不允許此使用者在更多裝置上進行驗證。
0x108D	4237	網路的設定不允許此裝置連線，因為已連線的裝置數目已達上限。
0x108E	4238	作業失敗，因為它所依賴的使用者驗證也失敗了。
0x108F	4239	收到無效的翻譯結果類型。
0x1090	4240	沒有成功驗證的使用者或進行中的驗證，就無法建立端點。
0x1092	4242	填入文字轉語音設定檔的要求遇到未處理的服務錯誤。
0x1094	4244	翻譯要求傳回了非預期的回應。
0x1098	4248	音訊裝置已被另一位使用者使用。
0x1099	4249	網路描述元格式不正確，因為總和檢查碼與預期值不符。
0x109A	4250	序列化的網路描述元格式不正確，因為總和檢查碼與預期值不符。
0x109B	4251	網路描述元是預留位置，目前無法在此裝置上使用。
0x109C	4252	序列化的網路描述元不是預期的格式。
0x109E	4254	建立邀請作業已取消。
0x109F	4255	撤銷邀請作業已取消。
0x10A2	4258	無法完成作業，因為邀請不存在。
0x10A4	4260	服務品質信標伺服器區域名稱無效。
0x10A5	4261	服務品質信標伺服器主機名稱無效。
0x10A6	4262	服務傳回的服務品質信標伺服器區域數目超過支援的數目。
0x10AA	4266	網路作業無法完成，因為建立網路失敗。
0x10AB	4267	存取指定的音訊輸出受到限制。
0x10AC	4268	無法初始化音訊裝置，因為應用程式沒有麥克風焦點。
0x10AD	4269	未初始化任何音訊裝置，因為應用程式沒有麥克風焦點。
0x10AE	4270	找不到指定使用者的音訊裝置。
0x10AF	4271	已識別使用者，但找不到相關聯的音訊裝置。
0x10BA	4282	翻譯作業因聊天控制項終結而取消。
0x10BC	4284	服務無法驗證提供的文字轉語音設定檔。
0x10BD	4285	服務無法配置網路，因為要求的版本無效。
0x10C7	4295	此裝置已與 Party 網路中斷連線，因為它長時間沒有已驗證的使用者。
0x10C8	4296	音訊裝置選取內容無效。
0x10C9	4297	聊天文字字串不能是空的。
0x10CB	4299	找不到 XAudio 2.8 和 2.9。這些程式庫分別內建於 Windows 8 和 Windows 10。
0x10CD	4301	無法執行要求的作業，因為網路已在終結中。
0x10CE	4302	音訊裝置已被另一個應用程式使用，無法初始化。
0x10CF	4303	音訊裝置在初始化期間被移除。
0x10D0	4304	找不到或無法載入 Party 模組。
0x10D1	4305	不支援指定的 PartyOption。
0x10D2	4306	此 PartyOption 不支援指定的物件類型。
0x10D4	4308	記憶體配置回呼和記憶體釋放回呼必須都為 null 或都不為 null。
0x10D5	4309	已呼叫過 SetMemoryCallbacks，在此處理程序的存留期間內無法再次呼叫。
0x10D7	4311	Cognitive Services 權杖已過期，但尚未重新整理。
0x10D8	4312	音訊串流沒有足夠的空間處理緩衝區。
0x10DA	4314	來源文字未包含任何可合成的字元。
0x10DC	4316	使用者拒絕存取音訊裝置。
0x10DF	4319	已識別指定的 PartyOption，但此作業類型 (get/set) 不支援它。
0x10E0	4320	無法處理語音服務所提供之轉譯中的不雅用語標籤。
0x10E1	4321	無法剖析語音服務所指出之不雅用語標籤內的字串。
0x10E3	4323	無法剖析轉譯，因為它包含保留給 Party 網路通訊協定的 XML 標籤。
0x10E5	4325	在處理程序的存留期間內，一旦進行過任何其他 API 呼叫，就無法設定記憶體回呼。
0x10E6	4326	提供給 PlayFab 服務的要求具有無效的參數。可能已將無效的區域提供給 CreateNewNetwork。
0x10EA	4330	PlayFab 服務傳回了未知的錯誤碼。
0x10EB	4331	PlayFab 服務傳回了非預期的錯誤碼。
0x10EC	4332	PlayFab 服務傳回了具有 4XX 狀態碼的非預期錯誤。
0x10ED	4333	PlayFab 服務傳回了具有 5XX 狀態碼的非預期錯誤。
0x10FD	4349	目標端點清單包含多個端點，但統計資料清單包含僅支援單一端點的統計資料類型。
0x10FE	4350	目標端點清單包含本機端點，但統計資料清單包含僅支援遠端端點的統計資料類型。
0x110B	4363	服務無法配置符合要求的網路。組建別名可能設定不正確。
0x110D	4365	語言代碼不能是空的。
0x110E	4366	提供的共用屬性索引鍵和值的大小總和超過允許的大小上限。
0x110F	4367	提供了重複的共用屬性索引鍵。
0x1110	4368	提供了空的共用屬性值。
0x1112	4370	提供的共用屬性數目超過允許的數目上限。
0x1114	4372	共用屬性索引鍵超過允許的索引鍵長度上限。
0x1119	4377	Party 文字聊天篩選層級無效。
0x111A	4378	提供給 PlayFab 服務的要求具有無效的參數。可能已將無效的區域提供給 CreateNewNetwork。
0x111E	4382	提供了空的共用屬性索引鍵。
0x1122	4386	無法解析服務品質信標主機名稱。
0x1123	4387	服務品質信標主機名稱沒有任何相關聯的 IP 位址。
0x1124	4388	解析服務品質信標主機名稱未傳回任何結果。
0x1128	4392	PartyRegionUpdateMode 值無效。
0x1129	4393	區域更新設定的重新整理間隔值無效。
0x112A	4394	區域品質測量總逾時值無效。
0x112B	4395	區域品質測量高延遲提示值無效。
0x112C	4396	區域品質測量所需最少成功回應數值無效。
0x112D	4397	區域品質測量理想成功回應數值無效。
0x1136	4406	網路正在終結，因為它處於閒置狀態。
0x113C	4412	使用者預設平台音訊裝置監視器未初始化；它可能已失敗，或此平台不支援它。

平台專屬錯誤

十六進位	十進位	描述
0x3000	12288	執行緒親和性遮罩未指定任何可供 XAudio2 將其執行緒設定親和性的有效處理器。
0x3001	12289	Unmapped XAudio2 error.
0x3002	12290	音訊作業失敗，因為 Windows 音訊服務未執行。
0x3003	12291	嘗試讀取環境變數時發生未指定的平台錯誤。
0x3004	12292	找不到音訊裝置介面路徑。
0x3005	12293	此平台不支援裝置選取類型。
0x3006	12294	無法初始化 Android 音訊裝置。
0x3009	12297	Android 音訊轉譯裝置尚未就緒。
0x300B	12299	找不到 iOS 音訊單元。
0x300C	12300	無法設定 iOS 音訊單元的格式。
0x300E	12302	無法初始化 iOS 音訊單元。
0x300F	12303	執行緒親和性遮罩未指定任何可供 Android 將其執行緒設定親和性的有效處理器。
0x3010	12304	無法設定執行緒親和性。
0x3011	12305	未指定平台使用者。
0x3014	12308	找不到 Microsoft 遊戲執行階段 DLL。
0x3015	12309	Microsoft 遊戲執行階段 DLL 不支援此版本的 GDK。
0x3016	12310	作業失敗，因為 Microsoft 遊戲執行階段需要應用程式視窗位於前景。
0x3017	12311	Microsoft 遊戲執行階段處於暫停狀態。
0x3018	12312	無法新增此使用者，因為已將使用者數目上限新增至 Microsoft 遊戲執行階段。
0x3019	12313	Microsoft 遊戲執行階段作業失敗，因為使用者已登出。
0x301A	12314	Microsoft 遊戲執行階段需要 UI 才能解決使用者的問題。
0x301B	12315	Microsoft 遊戲執行階段中無法使用延遲。
0x301C	12316	在 Microsoft 遊戲執行階段中找不到符合識別碼的使用者。
0x301D	12317	Microsoft 遊戲執行階段沒有預設使用者。
0x301E	12318	Microsoft 遊戲執行階段無法解析必要的使用者權限。
0x3020	12320	呼叫 PartyManager::Initialize() 之前必須先初始化網路堆疊；請使用 Microsoft Game Core XNetworkingGetConnectivityHint API 判斷網路堆疊何時已初始化。
0x3021	12321	設定 PartyLocalUdpSocketBindAddressOptions::ExcludeGameCorePreferredUdpMultiplayerPort 選項時，呼叫者必須傳遞連接埠值 0。
0x3022	12322	除了 Microsoft Game Core 版本之外，在所有版本的 PlayFab Party 中傳遞 PartyLocalUdpSocketBindAddressOptions::ExcludeGameCorePreferredUdpMultiplayerPort 都是無效的。
0x3023	12323	使用者和/或裝置未獲授權使用要求的沙箱，或未獲授權在目前的沙箱中使用要求的遊戲。
0x3024	12324	使用 Microsoft Game Core 版本的程式庫時，必須在遊戲暫停時清除程式庫，並在遊戲繼續時重新初始化。
0x302F	12335	無法查詢系統慣用的 UDP 多人遊戲連接埠。
0x3030	12336	雜訊抑制模型無法初始化。
0x3032	12338	未對應的 Microsoft 遊戲執行階段錯誤。

最後修改於 2026年10月8日

⌘I