360SDK登录服务

1.初始化接口【客户端调用】（必接）

    在应用主Activity中，使用Matrix的init方法（注：一定要在主线程调用）

public static void init(final Activity activity)
用于初始化360SDK，在应用主Activity的onCreate()函数中必须调用1次该方法，否则360SDK处于未初始化状态，无法使用其他接口。
当360SDK处于未初始化状态时，调用其任何接口都会返回错误，错误码为-101。
参数：
activity activity对象
使用例子：
Matrix.init(this);

2.登录授权流程

    360开放平台的登录流程使用Oauth2协议标准授权流程。

登录流程

    1. 应用客户端调用SDK进行登录 (见本章的接口介绍)；

    2. 360SDK与360 服务器通信进行用户登录，返回登录结果及用户信息；

    3. 360SDK把登录结果返给应用客户端，登录完成。

注意事项

    1. 360SDK登录接口返回的用户信息中没有qid。如果游戏想要获取qid，需要通过应用服务器端向360服务器端发起请求，用access token换取qid，具体调用方式见『获取用户信息接口』。

    2. 如果用户重新登陆，会获取到新的token，原token即失效。用户若用同样账号在不同设备上登录同一游戏, 只有最后一次登录获取的token是最终有效的。

    3. 调用任何其他需要登录后才能调用的接口时，如果360SDK未处于登录状态，会直接返回错误，错误码为-100。

    4. 调用注销接口或销毁接口会让360SDK回到未登录的状态。

3.接口介绍

3.1 登录接口【客户端调用】（必接）

功能说明：

    展示登录界面, 让用户登录。若登录成功，返回errno为0并带有用户信息。

    登录成功返回结果，登录失败会停留在登录界面，除非用户按返回键取消登录尝试。

    注意：获取用户信息后，应用需要保存自身账号与360账号的绑定关系。

接口示例：

    /**
     * 使用360SDK的登录接口, 生成intent参数
     * 
     * @param isLandScape 是否横屏显示登录界面
     */
    private Intent getLoginIntent(boolean isLandScape) {
Intent intent = new Intent(this, ContainerActivity.class);
    // 必需参数，使用360SDK的登录模块
    intent.putExtra(ProtocolKeys.FUNCTION_CODE,
ProtocolConfigs.FUNC_CODE_LOGIN);
// 可选参数，360SDK界面是否以横屏显示，默认为true，横屏
intent.putExtra(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE,
    isLandScape);
    //可选参数，是否显示关闭按钮，默认不显示
    intent.putExtra(ProtocolKeys.IS_LOGIN_SHOW_CLOSE_ICON,
getCheckBoxBoolean(R.id.isShowClose));
    // 可选参数，是否支持离线模式，默认值为false
    intent.putExtra(ProtocolKeys.IS_SUPPORT_OFFLINE,
getCheckBoxBoolean(R.id.isSupportOffline));
    // 可选参数，是否在自动登录的过程中显示切换账号按钮，默认为false
    intent.putExtra(ProtocolKeys.IS_SHOW_AUTOLOGIN_SWITCH,
getCheckBoxBoolean(R.id.isShowSwitchButton));
    // 可选参数，是否隐藏欢迎界面
    intent.putExtra(ProtocolKeys.IS_HIDE_WELLCOME,
getCheckBoxBoolean(R.id.isHideWellcome));
  /*
 * 指定界面背景（可选参数）：
 *  1.ProtocolKeys.UI_BACKGROUND_PICTRUE 使用的系统路径，如/sdcard/1.png
 *  2.ProtocolKeys.UI_BACKGROUND_PICTURE_IN_ASSERTS 使用的assest中的图片资源，
 *    如传入bg.png字符串，就会在assets目录下加载这个指定的文件
 *  3.图片大小不要超过5M，尺寸不要超过1280x720，后缀只能是jpg、jpeg或png
 */
// 可选参数，登录界面的背景图片路径，必须是本地图片路径
intent.putExtra(ProtocolKeys.UI_BACKGROUND_PICTRUE, getUiBackgroundPicPath());
// 可选参数，指定assets中的图片路径，作为背景图
intent.putExtra(ProtocolKeys.UI_BACKGROUND_PICTURE_IN_ASSERTS,
                    getUiBackgroundPathInAssets());
// 可选参数，是否需要用户输入激活码，用于游戏内测阶段。
// 如果不需激活码相关逻辑，客户传false或者不传入该参数。
intent.putExtra(ProtocolKeys.NEED_ACTIVATION_CODE,
getCheckBoxBoolean(R.id.isNeedActivationCode));
 
    //-- 以下参数仅仅针对自动登录过程的控制
    // 可选参数，自动登录过程中是否不展示任何UI，默认展示。
    intent.putExtra(ProtocolKeys.IS_AUTOLOGIN_NOUI,
getCheckBoxBoolean(R.id.isAutoLoginHideUI));
    // 可选参数，静默自动登录失败后是否显示登录窗口，默认不显示
    intent.putExtra(ProtocolKeys.IS_SHOW_LOGINDLG_ONFAILED_AUTOLOGIN,
getCheckBoxBoolean(R.id.isShowDlgOnFailedAutoLogin));
    // 社交分享测试参数，发布时要去掉，具体说明见分享接口
// intent.putExtra(ProtocolKeys.IS_SOCIAL_SHARE_DEBUG, 
//                   getCheckBoxBoolean(R.id.isDebugSocialShare));
    return intent;
}
// 调用接口
protected void doSdkLogin(boolean isLandScape) {
    mIsInOffline = false;
Intent intent = getLoginIntent(isLandScape);
IDispatcherCallback callback = mLoginCallback;
    if (getCheckBoxBoolean(R.id.isSupportOffline)) {
        callback = mLoginCallbackSupportOffline;
    }
Matrix.execute(this, intent, callback);
}

返回数据格式：

非离线模式下返回的数据格式：

{
    "data": {
        "expires_in": "36000",
        "scope": "",
        "refresh_token": "",
        "access_token": "6461171100c3bfa3cba24cc332d7d78b311d2bf590f4877c9" // token
    },
    "errno": 0
}

离线模式下返回的数据格式：

{
 data: {
  mode: "offline" // mode 值为offline代表进入离线模式
 },
 errno: 1 // errno 值为1
}

callback示例：

// 登录接口回调（不支持离线模式）
// 登录、注册的回调
privateIDispatcherCallback mLoginCallback = newIDispatcherCallback() {
 
    @Override
    publicvoid onFinished(String data) {
            // press back
            if (isCancelLogin(data)) {
                return;
            }
            // 显示一下登录结果
            Toast.makeText(SdkUserBaseActivity.this, data, Toast.LENGTH_LONG).show();
            mIsInOffline = false;
            mQihooUserInfo = null;
            // 解析access_token
            mAccessToken = parseAccessTokenFromLoginResult(data);
 
            if (!TextUtils.isEmpty(mAccessToken)) {
// 需要去应用的服务器获取用access_token获取一下用户信息
                getUserInfo();
            } else {
                Toast.makeText(SdkUserBaseActivity.this, "get access_token failed!",
  Toast.LENGTH_LONG).show();
            }
 
    }
};
 
// 登录结果回调（支持离线模式）
private IDispatcherCallback mLoginCallbackSupportOffline
  = new IDispatcherCallback() {
    @Override
    public void onFinished(String data) {
        if (isCancelLogin(data)) {
            return;
        }
        Log.d(TAG, "mLoginCallbackSupportOffline, data is " + data);
        try {
            JSONObject joRes = new JSONObject(data);
            JSONObject joData = joRes.getJSONObject("data");
            String mode = joData.optString("mode", "");
            if (!TextUtils.isEmpty(mode) && mode.equals("offline")) {
                Toast.makeText(SdkUserBaseActivity.this,
                    "login success in offline mode",
                     Toast.LENGTH_SHORT).show();
                mIsInOffline = true;
                // 显示一下登录结果
                Toast.makeText(SdkUserBaseActivity.this, data,
                    Toast.LENGTH_LONG).show();
            } else {
                mLoginCallback.onFinished(data);
            }
        } catch (Exception e) {
            Log.e(TAG, "mLoginCallbackSupportOffline exception", e);
        }
    }
};

3.2 切换账号接口【客户端调用】

功能说明：

    游戏方需要在游戏的菜单中添加“切换账号”的入口，方便用户切换账号。

    应用调用360SDK切换账号接口, 360SDK显示登录页面，用户可更换账号进行登录。之后的登录流程和返回结果与登录接口一样。

示例代码：

/**
     * 使用360SDK的切换账号接口
     * 
     * @param isLandScape 是否横屏显示登录界面
     */
protected void doSdkSwitchAccount(boolean isLandScape) {
Intent intent = getSwitchAccountIntent(isLandScape);
Matrix.invokeActivity(this, intent, mAccountSwitchCallback);
}

intent参数说明：

    除FUNCTION_CODE外，其他同登录接口

intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_SWITCH_ACCOUNT);

callback的 json格式说明：

同登录接口

3.3 获取用户信息【服务端调用】（选接）

    应用服务端获取access token后, 可调用360开放平台服务器端接口/user/me, 获取360用户id以及其它用户信息.

    接口地址为 https://openapi.360.cn/user/me

    获取用户信息后，应用需要保存游戏自身账号与360用户id（请务必使用360用户id，只有360用户id具有唯一标识性）的绑定关系。并且妥善保存用户信息留待以后使用.

参数说明：

返回参数：

请求示例：

https://openapi.360.cn/user/me.json?access_token=12345678983b38aabcdef387453ac8133ac3263987654321&fields=id,name,avatar,sex,area

返回示例：

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
 "id": "201459001",
 "name": "360U201459001",
 "avatar": "http://u1.qhimg.com/qhimg/quc/...ed6e9c53543903b",
 "sex": "未知"
 "area": ""
}