GCloud TConnd 鉴权接入指引
注意
使用 Player Network 鉴权,后台 TConnd 需要升级到 V3.2.4 或以上版本。
游戏通过 Player Network SDK、MSDK、WeGame 拉起的登录渠道来获得玩家的 openID、Token 等授权信息。
函数定义
- Unity
- Unreal Engine
{
// 设置玩家登录信息(V2.0.8 已废弃)
// gConnector.SetUserInfo(SDK_APPID, ChannelType.XXX, OpenID, Token);
// 设置鉴权票据信息(V2.0.8 新增)
gConnector.SetAuthInfo(AuthType, ChannelType.XXX, SDK_APPID, OpenID, Token, ExtInfo);
}
{
// 设置玩家登录信息(V2.0.8 已废弃)
// mConnector->SetUserInfo(APPID, ChannelType, OpenID, Token, -1);
// 设置鉴权票据信息(V2.0.8 新增)
mConnector->SetAuthInfo(AuthType, ChannelType, APPID, OpenID, Token,ExtInfo);
}
入参说明
参数 | 说明 |
---|---|
AuthType | 游戏平台选择的鉴权类型 Player Network SDK:AuthType.INTL ITOP/MSDKv5:AuthType.MSDKv5 MSDK-PC:AuthType.MSDKPC MSDKv3:AuthType.MSDKv3 WeGame:AuthType.WeGame |
AppID | 游戏平台侧注册的 AppId Player Network SDK:Player Network SDK 分配的 GameID ITOP/MSDKv5/MSDK-PC:ITOP/MSDK 的 GameID MSDKv3:QQ/WeChat 的 AppID WeGame:WeGame 的游戏 ID |
ChannelType | 玩家的登录渠道,如 QQ、WeChat、Facebook 等 |
OpenID | 玩家登录后,平台侧返回的用户 ID Player Network SDK/ITOP/MSDKv5/MSDK-PC:统一 openId MSDKv3:原始渠道 OpenID WeGame:RailID |
Token | 玩家登录后,平台侧返回的 Token Player Network SDK/ITOP/MSDKv5/MSDK-PC:token MSDKv3:原始渠道 AccessToken WeGame:session_ticket |
ExtInfo | 平台要求的鉴权扩展信息 (可选) 例如:云游戏鉴权的标记 cgsource=gamematrix 默认值:空 |
AuthType
或者ChannelType
填写 None(0),GCloud 客户端将启用无鉴权模式,此时后台 TConnd 的EnableNoAuth
需配置为 1 或 2。- 由于第三方渠道种类较多,
GCloud.ChannelType
未完全定义所有的类型。使用 Player Network SDK 或 MSDKv5 的游戏,可按照对应 SDK 的渠道定义进行增加扩展,或在自行定义扩展(enum > 0x8000)
后与后台 TConnd 协商一致。
更多详情,请参见 Unity 或 UE 的客户端 SDK 接入指南,TConnd 接入文档,或联系 [GCloud 人工服务]。