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 实体 ID 无效。
0x0020	32	PlayFab 令牌过大。
0x0022	34	指定的 PlayFab 实体 ID 尚未提供给 Party 库。
0x0023	35	PlayFab 实体令牌格式错误或无效。
0x0024	36	用户无权执行该操作。
0x0026	38	必须提供至少一个包含至少一个字节的数据缓冲区。
0x0029	41	指定的参数有效,但未实现相应支持。
0x002C	44	在验证 PlayFab 实体令牌时遇到错误。
0x002D	45	提供的网络配置结构无效。
0x002E	46	提供的邀请未指定标识符。
0x002F	47	提供的邀请指定了过多的实体 ID。
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 多线程单元中的线程调用的。
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	客户端找不到指定的终结点 ID。
0x1023	4131	指定的终结点 ID 无效或超出范围。
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	未映射的 XAudio2 错误。
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 游戏运行时中未找到与 ID 匹配的用户。
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月20日

⌘I