腾讯 QQ 登录

更新时间: 2025-05-14 08:32:28
编辑

准备工作

在 QQ 开放平台 (opens new window) 及 Authing Console 控制台 (opens new window)进行配置，请参阅 腾讯 QQ 接入准备、腾讯 QQ 官方文档 (opens new window)。

此功能在 android guard sdk 1.5.0 版本新增。


集成步骤

第一步：添加依赖

  1. 在项目根目录下的 build.gradle 添加 jcenter 引用：
jcenter()
  1. 在项目的 build.gradle 的 dependencies 添加依赖：
implementation 'cn.authing:guard:+'
implementation 'com.tencent.tauth:qqopensdk:3.52.0'

Guard 只是 compileOnly 依赖 qqopensdk，这样可以让 App 按需引入，防止 Guard aar 包随着支持的第三方登录增加而越来越大。所以每增加一个第三方身份源，都需要 App 手动加上该身份源的依赖。

第二步：配置 AndroidManifest

  1. 打开 /app/manifest/AndroidManifest.xml 文件，配置权限：

    <uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

  2. 配置 activity，如你的 AppId 是 “222222”，则<data>标签应该是这样的<data android:scheme="tencent222222" />：

    <activity
     android:name="com.tencent.tauth.AuthActivity"
     android:noHistory="true"
     android:launchMode="singleTask" >
  <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tencent你的AppId" />
  </intent-filter>
</activity>

第三步：初始化

在应用启动的时候初始化 Guard Android SDK：

// context is application or initial activity
// ”AUTHING_APP_ID“ is obtained from the Authing console
Authing.init(context, "AUTHING_APP_ID");
Authing.setAuthProtocol(Authing.AuthProtocol.EOIDC)

第四步：分场景使用

  • 使用托管页

    在需要登录认证的地方启动托管页：
// this is the activity context
AuthFlow.start(this);

通过以上步骤即可简单快速地通过配置 Authing 管理控制台后自动拥有 QQ 登录功能，登录入口会在 Guard 内置登录界面的社会化登录按钮列表中体现。

  • 使用 QQ 登录按钮

    如果使用我们提供的 QQ 登录按钮。

​ 1. 布局文件里面加上如下代码：

 <cn.authing.guard.social.view.QQLoginButton
    android:id="@+id/btn_login"
    android:background="@drawable/authing_button_background"
    android:textColor="@color/white"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

​ 2. 然后在代码里面处理事件：

QQLoginButton button = findViewById(R.id.btn_login);
button.setOnLoginListener(new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
      	if (code == 200) {
        	// 登录成功，data 是用户信息
       	} else {
        	// 登录失败
      	}
    }
});

  • 使用 QQ 登录授权类

    如果不想使用我们内置的按钮，想完全自己实现 UI，则可以在按钮的点击事件里面调用 QQ 类的授权函数，此类集成了拉起 QQ 授权登录的业务逻辑：
QQ.getInstance().login(appContext, new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
        if (code == 200) {
          // 登录成功，data 是用户信息
        } else {
          // 登录失败
        }
    }
});

​ data 包含 idToken 以及用户信息（用户名、昵称、姓名等）。

注意：使用 QQ 登录按钮或者 QQ 登录授权类时，需要在 Activity 的 onActivityResult 函数中加入如下代码：

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    QQ.getInstance().onActivityResult(requestCode, resultCode, data);
}

  • 使用 QQ 登录 API

    如果想完全自己实现 QQ 登录 UI 以及获取授权码逻辑，拿到授权码后，可以调用下面 API 换取用户信息：

public static void loginByQQ(String accessToken, @NotNull AuthCallback<UserInfo> callback)

参数

accessToken QQ token

示例

如果你只需要获取到用户信息（用户名、昵称、姓名等）和 idToken，调用：

AuthClient.loginByQQ(accessToken, new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
        if (code == 200) {
          // 登录成功，data 是用户信息, 包含 idToken。
        } else {
          // 登录失败
        }
    }
});

如果你需要获取到用户信息（用户名、昵称、姓名等）、idToken、accessToken 和 refreshToken，调用：

OIDCClient oidcClient = new OIDCClient();
oidcClient.loginByQQ(accessToken, new AuthCallback<UserInfo>() {
    @Override
    public void call(int code, String message, UserInfo data) {
        if (code == 200) {
          // 登录成功，data 是用户信息, 包含 idToken、accessToke and refreshToken。
        } else {
          // 登录失败
        }
    }
});