04/29/2024 11:54:53

解决方案

1、 Apple 登录的按钮样式和位置，MSDK侧是否有相关规范或者要求？

MSDK 侧无样式要求，苹果侧有一些要求，详情可以咨询下协同规划侧，联系MSDK助手对接。

2、Apple 登录的用户有要求归为哪个服务器？

因为苹果要求 Apple 登录与其他登录方式平级。所以需要单开苹果服务器，逻辑可以参考游客登录的逻辑，详情可以咨询下协同规划侧，联系MSDK助手对接。

3、对于国内发布的游戏或应用，MSDK是否支持将苹果账号和玩家现有账号（微信/QQ）绑定的功能？

MSDK 没有提供将苹果账号与玩家现有账号绑定的能力（MSDK 的绑定能力仅限海外）。

4、Apple 区的米大师初始化参数要填什么？

米大师初始化参数可参考 https://wiki.midas.qq.com/post/index/1/42/264/0 ，详情需要咨询 Midas助手确认。

5、Apple 证书如何添加 Sign in With Apple 能力？

Apple 证书相关能力，需要联系证书的提供者添加相应能力并更新证书。一般是联系 KeyStore-helper 证书助手或者蓝盾助手。切记，使用带有 Sign in With Apple 的能力的证书打包后，不要进行重签名操作。

6、游戏拉起 Apple 登录界面提示“未完成注册”，如下图所示。

游戏/应用需要联系证书提供方，一般是联系 KeyStore-helper 证书助手或者蓝盾助手，重新刷新证书的 Apple 登录能力后，一般可以解决问题。

7、Apple 登录时有如下日志，关键错误码 -7026。

Authorization failed: Error Domain=AKAuthenticationError Code=-7026 "(null)" UserInfo={AKClientBundleID=com.tencent.xxx.
关键现象：无法拉起 AppleID 登录界面
-7026 的错误一般发生在客户端配置问题（包括但不限于证书能力、XCode 工程中 Capability 的配置等），业务可以根据Apple 渠道接入文档完整的排查下客户端配置。如果所有配置检查后都未发现问题，可以尝试在 XCode 工程中将相关 Apple 登录的配置全部清除后再手动添加上。

8、Apple 登录时有如下日志，关键错误码 -7022。

Authorization failed: Error Domain=AKAuthenticationError Code=-7022 "(null)" UserInfo={AKClientBundleID=com.tencent.xxxxx}
游戏/应用需要核对是否使用了 App Connet 中的沙箱测试账号，若使用了沙箱测试账号，需要更换为正常使用的账号来解决此问题。

9、Apple 登录时有如下日志，关键错误码 -3003。

apple login fail, ret: -3003 msg: signin with apple generate client secret failed.
游戏/应用需要前往 飞鹰系统 确认 Apple 相关参数，需要配置正确来解决此问题。
MSDKV5配置路径：游戏管理 -> 我的游戏 -> 登录信息 -> 联调环境配置/正式环境配置 Apple 登录渠道中配置。
MSDKV3配置路径：游戏管理 -> 我的游戏 -> SDK参数 -> 搜索：编辑iOS信息 -> MSDKV3苹果渠道配置（联调环境/正式环境）。

10、Apple 登录时有如下日志，关键错误码 3005。

1）Apple渠道需要实名
MSDK 默认会开启此渠道的实名功能。未实名过的账号登录此渠道后，会先返回 3005 通知弹出实名认证页，再返回 0 登录成功，如上图日志所示。
A.如果返回 3005 未弹出实名页，需要联系 cc_helper(中控助手) 配置此渠道的实名页。注意，正式或测试环境下配置完实名页面后，需要将 MSDK 切换至对应的环境下验证。
B.Apple 渠道实名页与其他渠道实名页样式一致。
2）Apple渠道不需要实名
需要联系 cc_helper(中控助手) 关闭此渠道的实名功能。