TapTap 好友指南

权限说明

Unity

Android

该模块需要如下权限：

权限	使用目的	权限申请时机
网络权限	用于访问网络数据	用户首次使用该功能时会申请权限

该模块将在应用中添加如下权限：

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

iOS

UE4

SDK 配置

可以在 下载页 获得 TapSDK，引入 TapTap 登录模块。

Unity

Unity 开发环境要求：Unity 2019.4 或更高版本

支持版本：

• Android：最低支持 5.0
• iOS：最低支持 iOS 11.0，Xcode 版本 14.1 或更高版本

SDK 可以通过 Unity Package Manager 导入或手动导入，二者任选其一。请根据项目需要选择。

方法一：使用 Unity Package Manager

NPMJS 安装

从 3.25.0 版本开始，TapSDK 支持了 NPMJS 安装，优势是只需要配置版本号，并且支持嵌套依赖。

在项目的 Packages/manifest.json 文件中添加以下依赖：

"dependencies":{
  "com.taptap.tds.friends":"3.30.1",
    "com.taptap.tds.login":"3.30.1",
    "com.taptap.tds.common":"3.30.1",
}

但需要注意的是，要在 Packages/manifest.json 中 dependencies 同级下声明 scopedRegistries：

"scopedRegistries": [
    {
      "name": "NPMJS",
      "url": "https://registry.npmjs.org/",
      "scopes": ["com.tapsdk", "com.taptap", "com.leancloud"]
    }
  ]

GitHub 安装

在项目的 Packages/manifest.json 文件中添加以下依赖：

"dependencies":{
  "com.taptap.tds.login":"https://github.com/TapTap/TapLogin-Unity.git#3.30.1",
    "com.taptap.tds.common":"https://github.com/TapTap/TapCommon-Unity.git#3.30.1",
    "com.leancloud.storage":"https://github.com/leancloud/csharp-sdk-upm.git#storage-2.3.0", 
}

在 Unity 顶部菜单中选择 Window > Package Manager 可查看已经安装在项目中的包。

方法二：手动导入

1. 在 下载页 找到 TapSDK Unity 下载地址，下载 TapSDK-UnityPackage.zip 。

2. 在 Unity 项目中依次转到 Assets > Import Packages > Custom Packages，从解压后的 TapSDK-UnityPackage.zip 中，选择希望在游戏中使用的 TapSDK 包导入，其中：

• TapTap_Common.unitypackage TapSDK 基础库，必选。
• TapTap_Login.unitypackage TapTap 登录库，必选。

3. 从 LeanCloud-SDK 下载页 中下载并解压 LeanCloud-SDK-Storage-Unity.zip，然后将 Plugins 文件夹拖拽至 Unity 即可。

Android

repositories{  
  flatDir {  
      dirs 'libs'  
  }  
}  
dependencies {  
  implementation (name:'TapLogin_3.30.1', ext:'aar')
  implementation (name:'TapCommon_3.30.1', ext:'aar')
}

iOS

TapCommonResource.bundle
TapLoginResource.bundle
TapLoginSDK.framework
TapCommonSDK.framework
// 3.29.4 版本需要添加 LibProtocolBuffers
LibProtocolBuffers.framework

获取好友列表

调用前请确保登录时已申请好友权限，即使用 TapTap 登录接口时 permissions 参数添加 user_friends。

Unity

TapFriendResult result = await TapFriends.QueryMutualList(cursor, size);
if (result?.FriendList?.Count > 0) {
    foreach (TapFriendInfo friendInfo in result.FriendList) {
        Debug.Log($"{friendInfo.Name}, {friendInfo.OpenId}, {friendInfo.Avatar}");
    }
}
Debug.Log($"下一游标：{result.Cursor}");

Android

TapFriends.queryMutualList(cursor, size, new TapFriendsCallback<TapFriendResult>() {
    @Override
    public void onSuccess(TapFriendResult tapFriendResult) {
        toast(" queryMutualList success = " + tapFriendResult);
    }

    @Override
    public void onFail(Throwable throwable) {
        toast("queryMutualList fail error = " + throwable);
    }
});

iOS

TapFriendQueryOption *option = [TapFriendQueryOption new];
option.size = 20;
option.cursor = nil;
[TapFriends queryMutualListWithOption:option
            callback:^(TapFriendResult *_Nullable result, NSError *_Nullable error) {
                if (error) {
                    NSLog(@"失败 error = %@",error);
                } else {
                    NSMutableArray<NSString *> *userInfos = [NSMutableArray array];
                    for (TapFriendInfo *friendInfo in result.data) {
                        [userInfos addObject:[NSString stringWithFormat:@"openid = %@ name = %@ avatar = %@",
                                                                        friendInfo.openid,
                                                                        friendInfo.name,
                                                                        friendInfo.avatar]];
                    }
                    NSLog(@"成功 result = %@ cursor = %@",  userInfos, result.cursor);
                }
            }];

上述参数中 cursor 为每页游标，第一页为 null，后续页游标从上一次返回结果中获取；size 为结果数量。

该接口返回结果 Result 包括好友信息集合和下一页游标 cursor，好友信息集合中每条信息包含的字段说明如下表：

字段名	描述
name	Tap 昵称
avatar	Tap 头像
openid	Tap 用户 openid

当游标 cursor 为 null 时，表示为最后一页数据。