登录

swan.login()

注意：请不要将游戏的首帧（首屏）渲染操作放在回调函数中，详情参考： 登录、授权、获取用户信息接口使用规范

调用接口获取登录凭证（code）进而换取用户登录态信息，包括用户的唯一标识（openid）及本次登录的 会话密钥（session_key）等。用户数据的加解密通讯需要依赖会话密钥完成。

1

swan.login(opts)

更多登录授权的流程参见： 登录授权流程说明

参数值：

success 回调函数：

形如 function (res) {...}，其中：

示例 1：

1
2
3
4
5
6
7
8

swan.login({
    success: res => {
        console.log('登录成功', res.code);
    },
    fail: function () {
        console.log('登录失败');
    }
});

示例 2：

注意：由于百度和微信的登录体系差异，建议对需要登录之后才可以玩的一些小游戏，采用示例 2 的编写方式强制登录。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

function baiduLogin() {
    swan.login({
        success: res => {
            // 登录成功后的业务逻辑
        },
        fail: function () {
            swan.showModal({
                title: "登录失败",
                content: "是否重新登录？",
                cancelText: "退出游戏",
                success: res => {
                    if (res.confirm) {
                        console.log("点击了确定");
                        baiduLogin();
                    }
                    else if (res.cancel) {
                        console.log("点击了取消");
                        swan.exit();
                    }
                }
            })
        }
    })
}
baiduLogin();

swan.checkSession()

通过上述接口获得的用户登录态拥有一定的时效性，用户越久未使用小游戏，用户登录态越有可能失效；反之如果用户一直在使用小游戏，则用户登录态一直保持有效。具体时效逻辑由百度APP 维护，对开发者透明。开发者可以调用 swan.checkSession() 接口检测当前用户登录态是否有效，登录态过期后开发者可以再调用 swan.login() 获取新的用户登录态。

1

swan.checkSession(opts)

参数值：

示例：

1
2
3
4
5
6
7
8

swan.checkSession({
    success: res => {
        console.log('登录态有效');
    },
    fail: function () {
        console.log('登录态无效');
    }
});

Session Key

小游戏在其服务端中发送 POST 请求到百度 OAuth2.0 授权服务地址，并带上对应的参数，便可获取到 Session Key。

更多登录授权的流程参见： 登录授权流程说明

获取 Session Key 的URL地址：

https://spapi.baidu.com/oauth/jscode2sessionkey

为了让您的智能小程序运行在联盟 App 上,我们对获取 SessionKey 的接口做了升级。新接口可以兼容获取百度内部 App 和百度外部 App 的 SessionKey。
您只需要将原接口地址 https://openapi.baidu.com/nalogin/getSessionKeyByCode更改为https://spapi.baidu.com/oauth/jscode2sessionkey,即可让您的智能小程序在其它App上自动实现账号关联。

获取Session Key需要的参数：

若参数无误，服务器将返回一段 JSON 文本，包含以下数据：

若请求错误，服务器将返回一段 JSON 文本，包含以下参数：

| 属性 | 描述 |
| | - |
| error | 错误码；关于错误码的详细信息请参考"错误码列表"一节。|
| error_description |错误描述信息，用来帮助理解和解决发生的错误。|

请求示例：

1
2
3
4
5

# curl -d "code=xxx&client_id=xxx&sk=xxx" https://openapi.baidu.com/nalogin/getSessionKeyByCode
{
    "openid": "ABCDEFG123",
    "session_key": "xxxxxx"
}

swan.getSwanId()

基础库 swan-game.js 1.0.14 版本开始支持。

获取 swanid。

机制说明：

由于宿主应用并不一定强制用户登录，因此用户也有可能处于未登录状态。此时开发者可能不希望通过调用 swan.login() 强制用户登录，而是希望直接使用用户的设备标识来关联用户，存储一些非敏感的数据。因此小游戏还提供一个 swanid 的标识，可视作用户的设备标识。

1. 用户在同一台设备上使用同一个开发者主体所开发的不同小游戏，得到的是相同的 swanid。
2. 用户在同一台设备上使用不同开发者主体所开发的不同小游戏，得到的 swanid 是不同的。

swanid 校验性有以下两种方法：

3. 采用 verify 接口请求服务端。
4. 对比接口返回中 swanid_signature 字段的值与采用 signature 计算方法 的计算值是否一致。

参数值：

success返回参数说明：

示例：

1
2
3
4
5

swan.getSwanId({
    success: res => {
        console.log(res.data.swanid);
    }
});

isLoginSync

基础库 swan-game.js 1.0.14 版本开始支持。

获取 百度APP登录状态。

返回参数说明：

示例：

1
2
3
4
5
6

try {
    var result = swan.isLoginSync();
    console.log('isLoginSync', result.isLogin);
} catch (e) {
    console.log('error', e);
}