sud.login
发起 OpenPaaS 登录,获取一次性临时登录凭证 code。用户身份验证由 OpenPaaS 运行环境完成,游戏侧不需要处理账号密码。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 登录成功回调 | |
| fail | function | 否 | 登录失败回调 | |
| complete | function | 否 | 接口结束回调,成功或失败均执行 |
回调参数
success
| 属性 | 类型 | 说明 |
|---|---|---|
| code | string | OpenPaaS 颁发的一次性临时登录凭证 |
fail
| 属性 | 类型 | 说明 |
|---|---|---|
| errCode | number | 错误码 |
| errMsg | string | 错误信息 |
complete 不携带参数,在 success 或 fail 之后调用,单次请求只执行一次。
注意事项
code只能使用一次,须原样提交给 Game SVR,由 Game SVR 调用 auth.code2session 换取session_key、openid、unionid。code不是登录态,不要在客户端复用或长期持有。登录态应由 Game SVR 换取会话信息后自行签发。auth.code2session必须在服务端调用。请求中携带game_id与secret,严禁出现在客户端代码里。session_key只能保存在 Game SVR,严禁下发到客户端、写入前端可读取的配置或输出到日志。它是解密与验签用户敏感数据的密钥,用法见用户敏感数据获取。
示例代码
javascript
sud.login({
success: (res) => {
// code 只能使用一次,应立即提交给 Game SVR 换取会话信息
console.log('登录成功,取得 code', res.code);
},
fail: (err) => {
console.error('登录失败', err.errCode, err.errMsg);
},
complete: () => {
console.log('登录调用结束');
},
});