概览
发布在中国的游戏需接入 MSDK，发布在中国外的地区和国家的游戏需要接入 Player Network SDK。由于 MSDK 和 Player Network SDK 的类名及 API 不一致，当游戏需要同时发布在包括中国在内的多个国家或地区时，分别接入 MSDK 和 Player Network SDK 会增加游戏研发 SDK 接入和后续代码维护的成本。基于此背景，CROS 和 Global 共同开发了 UnionAdapter 来适配 MSDK 和 Player Network SDK 接口，以解决游戏项目重复接入的问题，降低 SDK 接入和维护的成本。
注意
- 发行中国游戏请接入 MSDK 版本的 UnionAdapter 插件；发行海外游戏请接入 Player Network SDK 版本的 UnionAdapter 插件。UnionAdapter API 调用方式相同。切换国内和海外账号服务时，游戏只需替换为对应 SDK (MSDK/Player Network SDK) 即可。
- MSDK 的自建账号暂无正式环境，有自建账号接入需求请提前联系 MSDK。
警告
自 LI PASS V1.25.00 起，UnionAdapter 和 LI PASS 做了兼容并支持并存，业务可以在使用 LI PASS 的同时，同时收到 UnionAdapter 对应模块的回调。所有接口都做好适配，无须代码调整。
适配的模块列表
适配层 MethodID Names
- Unity
- Unreal Engine
| ID | Method ID | 说明 | 备注 |
|---|---|---|---|
| 00000 | METHODID_UNDEFINE | Undefine methodId | Player Network SDK & MSDK |
| 10101 | GUA_ACCOUNT_AUTOLOGIN | 自动登录 | Player Network SDK & MSDK |
| 10102 | GUA_ACCOUNT_LOGIN | 授权登录 | Player Network SDK & MSDK |
| 10103 | GUA_ACCOUNT_BIND | 绑定 | Player Network SDK & MSDK |
| 10104 | GUA_ACCOUNT_GET_LOGIN_RESULT | 获取登录态 | Player Network SDK & MSDK |
| 10105 | GUA_ACCOUNT_SWITCH_USER | Player Network SDK & MSDK | |
| 10106 | GUA_ACCOUNT_QUERY_USER_INFO | 获取个人信息 | Player Network SDK & MSDK |
| 10107 | GUA_ACCOUNT_LOGOUT | 登出 | Player Network SDK & MSDK |
| 10108 | GUA_ACCOUNT_LOGIN_WITH_CONFIRM_CODE | 使用确认码登录 | Player Network SDK & MSDK |
| 10109 | GUA_ACCOUNT_WAKEUP | 异账号 | Player Network SDK & MSDK |
| 10110 | GUA_ACCOUNT_SCHEME | Player Network SDK & MSDK | |
| 10111 | GUA_ACCOUNT_RESET_GUEST | 重置游客账号 | Player Network SDK & MSDK |
| 10112 | GUA_ACCOUNT_QUERY_CAN_BIND | 查询是否可以绑定 | Player Network SDK |
| 10113 | GUA_ACCOUNT_QUERY_ACTIVE_USER | 查询可用的用户 | Player Network SDK |
| 10114 | GUA_ACCOUNT_SHOW_ACCOUNT_PICKER | 显示用户列表 | Player Network SDK |
| 10115 | GUA_ACCOUNT_CHECK_ACTIVE_USER | 检查用户是否可用 | Player Network SDK |
| 10116 | GUA_ACCOUNT_NEED_REFRESH_USER | 刷新用户 | Player Network SDK |
| 10117 | GUA_ACCOUNT_REQUEST_VERIFY_CODE | 获取验证码 | Player Network SDK & MSDK |
| 10118 | GUA_ACCOUNT_RESET_PASSWORD | 重置密码 | Player Network SDK & MSDK |
| 10119 | GUA_ACCOUNT_MODIFY_ACCOUNT | 修改账号信息 | Player Network SDK & MSDK |
| 10120 | GUA_ACCOUNT_LOGIN_WITH_CODE | Player Network SDK & MSDK | |
| 10121 | GUA_ACCOUNT_QUERY_REGISTER_STATUS | 获取注册状态 | Player Network SDK & MSDK |
| 10122 | GUA_ACCOUNT_QUERY_VERIFY_CODE_STATUS | 获取验证码状态 | Player Network SDK & MSDK |
| 10123 | GUA_ACCOUNT_QUERY_IS_RECEIVE_EMAIL | 获取是否接收邮件 | Player Network SDK & MSDK |
| 10124 | GUA_ACCOUNT_REGISTER | 注册账号 | Player Network SDK |
| 10125 | GUA_ACCOUNT_MODIFY_PROFILE | 修改个人信息 | Player Network SDK |
| 10128 | GUA_ACCOUNT_LOGIN_WITH_MAPPED_CHANNEL | Player Network SDK | |
| 10129 | GUA_ACCOUNT_BUILD_MAP_WITH_LOGIN_CHANNEL | Player Network SDK | |
| 10130 | GUA_ACCOUNT_QUERY_TOKEN_ID | 查询 token ID | Player Network SDK |
| 10132 | GUA_ACCOUNT_UNBIND | 解除绑定 | Player Network SDK |
| 10133 | GUA_ACCOUNT_QUERY_USER_NAME_STATUS | 查询用户名状态 | Player Network SDK |
| 10134 | GUA_ACCOUNT_QUERY_DATA_PROTECTION_ACCEPTANCE | 查询数据保护验收 | Player Network SDK |
| 10135 | GUA_ACCOUNT_MODIFY_DATA_PROTECTION_ACCEPTANCE | 修改数据保护接受 | Player Network SDK |
| 10136 | GUA_ACCOUNT_QUERY_ACCOUNT_PROFILE | 查询账号信息 | Player Network SDK |
| 10137 | GUA_ACCOUNT_LAUNCH_ACCOUNT_UI | 打开账号 UI | Player Network SDK & MSDK |
| 10138 | GUA_ACCOUNT_QUERY_LEGAL_DOCUMENTS | 查询法务文件信息 | Player Network SDK |
| 10139 | GUA_ACCOUNT_MODIFY_LEGAL_DOCUMENTS | 修改法务文件信息 | Player Network SDK |
| 10140 | GUA_ACCOUNT_QUERY_BIND_INFO | 查询绑定关系 | Player Network SDK |
| 10141 | GUA_ACCOUNT_CONNECT | MSDK | |
| 10142 | GUA_ACCOUNT_UNCONNECT | MSDK | |
| 10143 | GUA_ACCOUNT_GETCONNECTRESULT | MSDK | |
| 10144 | GUA_ACCOUNT_BINDUI | MSDK | |
| 10146 | GUA_ACCOUNT_QRCODE | MSDK | |
| 10147 | GUA_ACCOUNT_CHECK_UL | MSDK | |
| 10148 | GUA_ACCOUNT_CHECK_AND_LOGIN | MSDK | |
| 10149 | GUA_ACCOUNT_CHECK | MSDK | |
| 10150 | GUA_ACCOUNT_BIND_WITH_CONFIRMCODE | MSDK | |
| 10151 | GUA_ACCOUNT_PERMISSION_AUTH | MSDK | |
| 10152 | GUA_ACCOUNT_CHANNEL_PERMISSION_AUTH | MSDK | |
| 10153 | GUA_ACCOUNT_CAN_BIND | MSDK | |
| 10154 | GUA_ACCOUNT_CANCEL_ACCOUNT_DELETION | 取消删号 (intl 141) | Player Network SDK |
| 10201 | GUA_FRIEND_SHARE | 分享 | Player Network SDK & MSDK |
| 10202 | GUA_FRIEND_SEND_MESSAGE | 发消息 | Player Network SDK & MSDK |
| 10203 | GUA_FRIEND_QUERY_FRIENDS | 获取好友列表 | Player Network SDK & MSDK |
| 10204 | GUA_FRIEND_ADD_FRIEND | MSDK | |
| 10301 | GUA_WEBVIEW_CLOSE_URL | 关闭网页 | Player Network SDK & MSDK |
| 10302 | GUA_WEBVIEW_GET_ENCRYPT_URL | 获取登录态加密票据 | Player Network SDK & MSDK |
| 10303 | GUA_WEBVIEW_JS_CALL | Native call JS | Player Network SDK & MSDK |
| 10304 | GUA_WEBVIEW_JS_SHARE | Player Network SDK & MSDK | |
| 10305 | GUA_WEBVIEW_JS_SEND_MESSAGE | Player Network SDK & MSDK | |
| 10306 | GUA_WEBVIEW_JS_IS_APP_INSTALLED | Player Network SDK | |
| 10307 | GUA_WEBVIEW_TOOLBAR_SHARE | Player Network SDK | |
| 10308 | GUA_WEBVIEW_EMBEDDED_PROGRESS | MSDK | |
| 10401 | GUA_PUSH_REGISTER | 注册推送 | Player Network SDK & MSDK |
| 10402 | GUA_PUSH_UNREGISTER | 注销推送 | Player Network SDK & MSDK |
| 10403 | GUA_PUSH_SET_TAG | 注册标签 | Player Network SDK & MSDK |
| 10404 | GUA_PUSH_DELETE_TAG | 注销标签 | Player Network SDK & MSDK |
| 10405 | GUA_PUSH_ADD_LOCAL_NOTIFICATION | 注册本地推送 | Player Network SDK & MSDK |
| 10406 | GUA_PUSH_CLEAR_LOCAL_NOTIFICATIONS | 清除本地推送 | Player Network SDK & MSDK |
| 10407 | GUA_PUSH_NOTIFICATION_CALLBACK | 推送回调 | Player Network SDK & MSDK |
| 10408 | GUA_PUSH_NOTIFICATION_SHOW | Player Network SDK & MSDK | |
| 10409 | GUA_PUSH_NOTIFICATION_CLICK | Player Network SDK & MSDK | |
| 10410 | GUA_PUSH_SET_ACCOUNT | Player Network SDK & MSDK | |
| 10411 | GUA_PUSH_DELETE_ACCOUNT | Player Network SDK & MSDK | |
| 10501 | GUA_NOTICE_REQUEST_DATA | 获取公告数据 | Player Network SDK & MSDK |
| 10601 | GUA_TOOLS_OPEN_DEEP_LINK | Player Network SDK & MSDK | |
| 10602 | GUA_TOOLS_CONVERT_SHORT_URL | Player Network SDK & MSDK | |
| 10603 | GUA_TOOLS_CUTOUT_INFO | 查询异步异形屏信息 | Player Network SDK |
| 10604 | GUA_TOOLS_FREE_FLOW | MSDK | |
| 10605 | GUA_TOOLS_RECOVER_GUEST | MSDK | |
| 10606 | GUA_TOOLS_DETECT_NETWORK | 网络诊断 (intl 1801) | Player Network SDK |
| 10607 | GUA_TOOLS_DNS_QUERY_IP_BY_HOST | DNS 按主机查询 IP (intl 1401) | Player Network SDK |
| 10701 | GUA_ANALYTICS_CRASH_EXTRA_MESSAGE | crash 的额外日志 | Player Network SDK & MSDK |
| 10702 | GUA_ANALYTICS_QUERY_DEVICE_LEVEL | 查询机型分档(intl 703) | Player Network SDK |
| 10703 | GUA_ANALYTICS_CRASH_EXTRA_DATA | MSDK | |
| 11301 | GUA_EXTEND_INVOKE | 扩展调用 | Player Network SDK & MSDK |
| ID | GUAMethodID | 说明 | 备注 |
|---|---|---|---|
| 00000 | kMethodIDUndefine | Undefine methodId | Player Network SDK & MSDK |
| 10101 | kMethodIDAccountAutoLogin | 自动登录 | Player Network SDK & MSDK |
| 10102 | kMethodIDAccountLogin | 授权登录 | Player Network SDK & MSDK |
| 10103 | kMethodIDAccountBind | 绑定 | Player Network SDK & MSDK |
| 10104 | kMethodIDAccountGetLoginRet | 获取登录态 | Player Network SDK & MSDK |
| 10105 | kMethodIDAccountSwitchUser | Player Network SDK & MSDK | |
| 10106 | kMethodIDAccountQueryUserInfo | 获取个人信息 | Player Network SDK & MSDK |
| 10107 | kMethodIDAccountLogout | 登出 | Player Network SDK & MSDK |
| 10108 | kMethodIDAccountLoginWithConfirmCode | 使用确认码登录 | Player Network SDK & MSDK |
| 10109 | kMethodIDAccountWakeUp | 异账号 | Player Network SDK & MSDK |
| 10110 | KMethodIDAccountScheme | Player Network SDK & MSDK | |
| 10111 | kMethodIDAccountResetGuest | 重置游客账号 | Player Network SDK & MSDK |
| 10112 | kMethodIDAccountQueryCanBind | 查询是否可以绑定 | Player Network SDK |
| 10113 | kMethodIDAccountQueryActiveUser | 查询可用的用户 | Player Network SDK |
| 10114 | kMethodIDAccountShowAccountPicker | 显示用户列表 | Player Network SDK |
| 10115 | kMethodIDAccountCheckActiveUser | 检查用户是否可用 | Player Network SDK |
| 10116 | kMethodIDAccountNeedRefreshUser | 刷新用户 | Player Network SDK |
| 10117 | kMethodIDAccountRequestVerifyCode | 获取验证码 | Player Network SDK & MSDK |
| 10118 | kMethodIDAccountResetPassword | 重置密码 | Player Network SDK & MSDK |
| 10119 | kMethodIDAccountModifyAccount | 修改账号信息 | Player Network SDK & MSDK |
| 10120 | kMethodIDAccountLoginWithCode | Player Network SDK & MSDK | |
| 10121 | kMethodIDAccountQueryRegisterStatus | 获取注册状态 | Player Network SDK & MSDK |
| 10122 | kMethodIDAccountQueryVerifyCodeStatus | 获取验证码状态 | Player Network SDK & MSDK |
| 10123 | kMethodIDAccountQueryIsReceiveEmail | 获取是否接收邮件 | Player Network SDK & MSDK |
| 10124 | kMethodIDAccountRegister | 注册账号 | Player Network SDK |
| 10125 | kMethodIDAccountModifyProfile | 修改个人信息 | Player Network SDK |
| 10128 | kMethodIDAccountLoginWithMappedChannel | Player Network SDK | |
| 10129 | kMethodIDAccountBuildMapWithLoginChannel | Player Network SDK | |
| 10130 | kMethodIDAccountQueryTokenID | 查询 token ID | Player Network SDK |
| 10132 | kMethodIDAccountUnbind | 解除绑定 | Player Network SDK |
| 10133 | kMethodIDAccountQueryUserNameStatus | 查询用户名状态 | Player Network SDK |
| 10134 | kMethodIDAccountQueryDataProtectionAcceptance | 查询数据保护验收 | Player Network SDK |
| 10135 | kMethodIDAccountModifyDataProtectionAcceptance | 修改数据保护接受 | Player Network SDK |
| 10136 | kMethodIDAccountQueryAccountProfile | 打开账号 UI | Player Network SDK |
| 10138 | kMethodIDAccountQueryLegalDocuments | 查询法务文件信息 | Player Network SDK |
| 10139 | kMethodIDAccountModifyLegalDocuments | 修改法务文件信息 | Player Network SDK |
| 10140 | kMethodIDAccountQueryBindInfo | 查询绑定关系 | Player Network SDK |
| 10141 | kMethodIDAccountConnect | MSDK | |
| 10142 | kMethodIDAccountUnconnect | MSDK | |
| 10143 | kMethodIDAccountGetConnectResult | MSDK | |
| 10144 | kMethodIDAccountBindUI | MSDK | |
| 10146 | kMethodIDAccountQRCode | MSDK | |
| 10147 | kMethodIDAccountCheckUL | MSDK | |
| 10148 | kMethodIDAccountCheckAndLogin | MSDK | |
| 10149 | kMethodIDAccountCheck | MSDK | |
| 10150 | kMethodIDAccountBindWithConfirmCode | MSDK | |
| 10151 | kMethodIDAccountPermissionAuth | MSDK | |
| 10152 | kMethodIDAccountChannelPermissionAuth | MSDK | |
| 10153 | kMethodIDAccountCanBind | MSDK | |
| 10154 | kMethodIDAccountCancelAccountDeletion | 取消删号 | Player Network SDK |
| 10201 | kMethodIDFriendShare | 分享 | Player Network SDK & MSDK |
| 10202 | kMethodIDFriendSendMessage | 发消息 | Player Network SDK & MSDK |
| 10203 | kMethodIDFriendQueryFriends | 获取好友列表 | Player Network SDK & MSDK |
| 10204 | kMethodIDFriendAddFriend | MSDK | |
| 10301 | kMethodIDWebviewCloseURL | 关闭网页 | Player Network SDK & MSDK |
| 10302 | kMethodIDWebviewGetEncryptUR | 获取登录态加密票据 | Player Network SDK & MSDK |
| 10303 | kMethodIDWebviewJSCall | Native call JS | Player Network SDK & MSDK |
| 10304 | kMethodIDWebviewJSShare | Player Network SDK & MSDK | |
| 10305 | kMethodIDWebviewJSSendMessage | Player Network SDK & MSDK | |
| 10306 | kMethodIDWebviewJSIsAppInstalled | Player Network SDK | |
| 10307 | kMethodIDWebviewToolbarShare | Player Network SDK | |
| 10401 | kMethodIDPushRegister | 注册推送 | Player Network SDK & MSDK |
| 10402 | kMethodIDPushUnregister | 注销推送 | Player Network SDK & MSDK |
| 10403 | kMethodIDPushSetTag | 注册标签 | Player Network SDK & MSDK |
| 10404 | kMethodIDPushDeleteTag | 注销标签 | Player Network SDK & MSDK |
| 10405 | kMethodIDPushAddLocalNotification | 注册本地推送 | Player Network SDK & MSDK |
| 10406 | kMethodIDPushClearLocalNotification | 清除本地推送 | Player Network SDK & MSDK |
| 10407 | kMethodIDPushNotificationCallback | 推送回调 | Player Network SDK & MSDK |
| 10408 | kMethodIDPushNotificationShow | Player Network SDK & MSDK | |
| 10409 | kMethodIDPushNotificationClick | Player Network SDK & MSDK | |
| 10410 | kMethodIDPushSetAccount | Player Network SDK & MSDK | |
| 10411 | kMethodIDPushDeleteAccount | Player Network SDK & MSDK | |
| 10501 | kMethodIDNoticeRequestData | 获取公告数据 | Player Network SDK & MSDK |
| 10601 | kMethodIDToolsOpenDeepLink | Player Network SDK & MSDK | |
| 10603 | kMethodIDToolsCutoutInfo | 查询异步异形屏信息 | Player Network SDK |
| 10604 | kMethodIDToolsFreeFlow | MSDK | |
| 10605 | kMethodIDToolsRecoverGuest | MSDK | |
| 10606 | kMethodIDToolsDetectNetwork | 网络诊断 (intl 1801) | Player Network SDK |
| 10607 | kMethodIDToolsDNSQueryIPByHost | DNS 按主机查询 IP (intl 1401) | Player Network SDK |
| 10602 | kMethodIDToolsConvertShortURL | Player Network SDK & MSDK | |
| 10701 | kMethodIDAnalyticsCrashExtraMessage | crash 的额外日志 | Player Network SDK & MSDK |
| 10702 | kMethodIDAnalyticsQueryDeviceLevel | 查询机型分档(intl 703) | Player Network SDK |
| 10703 | kMethodIDAnalyticsCrashExtraData | MSDK | |
| 11301 | kMethodIDExtendInvoke | 扩展调用 | Player Network SDK & MSDK |