com.tencent.tauth.Tencent.login
1. 接口说明
1. 如果开发者没有调用mTencent实例的setOpenId、setAccessToken接口,则该接口执行正常的登录操作;
2. 如果开发者先调用mTencent实例的setOpenId、setAccessToken接口,则该接口执行校验登录态的操作。如果登录态有效,则返回成功给app,如果登录态失效,则会自动进入登录流程,将最新的登录态数据返回给app。
建议应用每次启动时调用一次该接口(先调用setOpenId、setAccessToken),以确保每次打开应用时用户都是有登录态的。
2. 使用场景
用户使用QQ账号登录应用
3. 接口调用说明
3.1 接口方法
int com.tencent.tauth.Tencent.login(Activity activity, String scope, IUiListener listener)
3.2 参数说明
参数 | 参数说明 |
---|---|
activity | 调用者activity。应用使用SDK时,会从应用自己的Activity跳转到SDK的Activity,应用调用SDK的Activity即为这里的调用者activity。 |
scope |
应用需要获得哪些接口的权限,由“,”分隔,例如:SCOPE = “get_user_info,add_topic”;如果需要所有权限则使用"all"。 |
listener | 回调接口,IUiListener实例。 |
3.3 示例代码
public void login() { Tencent mTencent = Tencent.createInstance(AppID, this); if (!mTencent.isSessionValid()) { mTencent.login(this, Scope, new IUiListener() { @Override public void onError(UiError arg0) { // TODO Auto-generated method stub fail(arg0); } @Override public void onComplete(JSONObject arg0) { // TODO Auto-generated method stub success(arg0); } @Override public void onCancel() { // TODO Auto-generated method stub cancel(); } }); } }
3.4 返回码说明
0: 正确
其它: 失败
OpenAPI公共错误码说明详见:Android常见问题及公共返回码说明。