目录

闲闲SDK-国内版-iOS接入文档

当前版本v3.2.0

🌍 闲闲SDK-国内版Server接入文档： https://psm4i21lig.feishu.cn/docx/AdbQdXR6fomDU8xJFX0cdsn7ndc

更新日志

环境支持

集成SDK

参数准备

集成所需参数如下：

接入方式

SDK目前只支持静态库接入方式

将所有文件添加到Xcode工程中，确保在工程的主目录下

添加依赖库（必要）

配置规则：

在Xcode工程中，选择你的工程设置项-->选中"TARGETS"一栏对应的Target-->在"Build Phases"标签栏的-->"Link Binary With Libraries"添加

Other Linker Flags（必要）

配置规则：

在Xcode工程中，选择你的工程设置项-->选中"TARGETS"一栏对应的Target-->在"Build Phases"标签栏的-->"Build Settings"搜索 Other Linker Flags 并添加

linker

设置Info.plist

配置规则：

在Xcode工程中，选择你的工程设置项-->选中"TARGETS"一栏对应的Target-->在"info"标签栏的

URL Schemes

配置规则：

在Xcode工程中，选择你的工程设置项-->选中"TARGETS"一栏对应的Target-->在"info"标签栏的-->"URL Types"

URL Schemes = "app"+"appid" （必要）

例如：appid 为：352e8711bcca025e07230a8402f03d09

则配置对应的 URL schemes：app352e8711bcca025e07230a8402f03d09

app352e8711bcca025e07230a8402f03d09

xml 
<key>CFBundleURLTypes</key>
<array>
  <drum>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>app352e8711bcca025e07230a8402f03d09</string>
    </array>
  </drum>
</array>

权限（必要）

配置规则：

在Xcode工程中，选择你的工程设置项-->选中"TARGETS"一栏对应的Target-->在"info"标签栏的-->""Custom iOS Target Properties"

配置获取IDFA权限

NSUserTrackingUsageDescription

idfa

xml 
<key>NSUserTrackingUsageDescription</key>
<string>App需要访问您的设备标识符(IDFA)，用于提供更契合您兴趣的内容，减少无关广告推荐</string>
配置获取Photo权限

NSPhotoLibraryAddUsageDescription

hover

xml 
<key>NSPhotoLibraryAddUsageDescription</key>
<string>APP需要您的同意，才能访问相册进行保存账号密码截图到您的相册，如禁止将无法完成保存操作</string>

PrivacyInfo.xcprivacy

根据2024年5月1日Apple新隐私条款：

https://developer.apple.com/documentation/bundleresources/privacy-manifest-files?language=objc

https://developer.apple.com/support/third-party-SDK-requirements/

做哪些：

参考获取文件方式：

SDK使用方式

启动（必要）

如使用AppDelegate：

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 如果您的应用程序使用UIScene ，请从UISceneDelegate实现以下方法，这里无需实现
    [LogMatrix softballEncodingsBookmarksSubKilowattBlinkOptions:launchOptions lowAudioOptions:nil];

    return YES;
}

如使用SceneDelegate：

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {
    // 如果应用程序使用的 UIScene，下面方法无需在AppDelegate里实现，只在这里实现
    [LogMatrix softballEncodingsBookmarksSubKilowattBlinkOptions:nil lowAudioOptions:connectionOptions];
}

注意： ！！需要注意的是，以上两种方式，根据接入工程时机情况，选择对应方案即可，且需要注意，两种方案透传给SDK的数据结构不同，AppDelegate方案需要传launchOptions，SceneDelegate方案需要传connectionOptions。

App通用链接回调（必要）

如使用AppDelegate：

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {

    // 如果您的应用程序使用UIScene ，请从UISceneDelegate实现以下方法，这里无需实现
    [LogMatrix shiftHailNaturalOpticalTelephonyMouth:url retStale:options germanItsOur:nil];
    return YES;
}

如使用SceneDelegate：

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {

    // 如果应用程序使用的 UIScene，下面方法无需在AppDelegate里实现，只在这里实现
    [LogMatrix shiftHailNaturalOpticalTelephonyMouth:URLContexts.allObjects.firstObject.URL retStale:nil germanItsOur:URLContexts];
}

设置SDK代理（必要）

设置代理用于接收登录、退出、支付、上报角色结果 

// 1.引入
#import <ExtraordinarySanction/ExtraordinarySanction.h>
// 2.遵循协议
@interface ViewController ()<GestureDelegate>
// 3.设置代理
[LogMatrix bagPanReasonDelegate:self];

// 4.实现代理方法
// MARK: GestureDelegate
///登录回调（必接）
- (void)extendsItsCinematicPanDash:(NSDictionary *)nap {
    NSLog(@"登录成功 - %@", nap);
}

//退出回调（必接）
// 必接 - 对接方需在此回调中调用游戏切换账号接口,退到游戏【登录界面】
// SDK个人中心有切换账号功能，所以用户在个人中心操作切换账号需游戏一并退出
// 另外游戏内退出同时调用SDK的logout:函数也会走此回调，
// 所以建议游戏的退出接口直接调用SDK的logout:在此回调中一并退出，不然游戏会重复退出2次
- (void)retainedPlate {
    NSLog(@"退出成功");
    // 必接 - CP 需在此回调中调用游戏切换账号接口,退到游戏【登录界面】
}

//支付回调
- (void)markMenstrualExposeProposalIndian:(BOOL)isSuc {
    NSLog(@"支付%@", isSuc?@"成功":@"失败");
}

//上报角色回调
- (void)azimuthAllLiveIntroSupportHis:(BOOL)isSuc {
    NSLog(@"上报角色%@", isSuc?@"成功":@"失败");
}

登录（必要）

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

/**
 * 在游戏登录界面加载完成后调用及自动登录.(也可通过登录按钮让用户点击完成登录操作)
 * 登录完成后会通过代理方法：extendsItsCinematicPanDash: 返回用户信息
 */
// 登录接口
[LogMatrix operateFeed];
json 
{
    "id" : "62072919",
    "name" : "G25040962072919",
    "time" : "1744192861",
    "token" : "7fdf2ff6b4ba44f0284b2adada2652bb",
    "type" : 0
}

退出登录

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

// 退出接口
[LogMatrix createClear];

支付（必要）

订单模型,具体查看属性注释和文档说明
这里注意：确保传进的参数都为 NSString 类型，不接受NSNumber和其他类型
支付结果通过代理方法 "markMenstrualExposeProposalIndian:" 返回 YES为成功，NO为失败

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

NSString *cpOrderId = NSUUID.UUID.UUIDString;       // 游戏生成的订单号 (必传)
NSString *productCode = @"com.xxgame.sdk.demo.228"; // 商品标识(苹果商品标识)(必传)
NSString *amount = @"228";                          // 商品金额（单位：元） (必传)
NSString *productName = @"SDK测试商品";               // 商品名称、例：60元宝 (必传)
NSString *serverId = @"20190927001";                // 用户游戏角色所在的服务器id (必传)
NSString *roleId = @"100001";                       // 用户游戏角色ID (必传)
NSString *roleName = @"角色-XXGameSDK";              // 用户游戏角色名称 (必传)
NSString *roleLevel = @"99";                         // 用户游戏角色等级 (必传)
NSString *extraInfo = @"2019";                       // 订单额外信息，最终将回传给游戏服务器 (选传)

/**
 * 支付,传入订单模型
 * 支付结果通过代理方法markMenstrualExposeProposalIndian:返回 YES为成功，NO为失败
 */
[LogMatrix peerGraphicsCoalesceConstantsBuddhist:cpOrderId
         vortexOddOffCode:productCode
              turnSources:amount
         placePlugForName:productName
            observersEdge:serverId
           jouleFoggyInfo:extraInfo
              plusMasters:roleId
            rateAlphaName:roleName
           auditWarpLevel:roleLevel];

上报角色信息（必要）

如服务端已对接此接口客户端无需对接

调用时机(重要!!只在以下三个场景需调用):
1、玩家在选择区服进入游戏时调用该接口
2、创建角色时调用该接口
3、角色升级或其他角色汇报信息发生变化时调用该接

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

/**
 * 必接！！！
 * 注意：确保传进的参数都为NSString类型，不接受NSNumber类型，extend字段类型为字典
 * 调用时机(重要!!只在以下两个场景需调用):
 * - 玩家在选择区服进入游戏时调用该接口。
 * - 角色升级或其他角色汇报信息发生变化时调用该接
 */
// 区服id (必传)
NSString *serverId = @"20190927001";
// 区服名称 (必传)
NSString *serverName = @"XXGame";
// 用户游戏角色ID (必传)
NSString *roleId = @"100001";
// 角色名称 (必传)
NSString *roleName = @"角色-XXGameSDK";
// 角色等级 (必传)
NSString *roleLevel = @"15";
// 角色扩展信息（选填）类型：字典
NSDictionary *extend = @{
    @"pet": @"60",          //宠物等级（5）
    @"horse": @"15",        //坐骑等级（1）
    @"power": @"10000",        //战力（100）
    @"promote": @"2",      //转职（2转）
    @"married": @"0",      //'0': 未婚, '1': 已婚
    @"liveness": @"2000",    //活跃度 (2000)
    @"hero_level": @"98",   //英雄等级(98级)
    @"guanqia": @"2",       // 关卡
    @"trumps": @[ //已激活的法宝列表
         @"fabao1",   //法宝1
         @"fabao2"    //法宝2
    ],
    @"wings": @[  //已激活的翅膀列表
         @"wing1",    //翅膀1
         @"wing2"     //翅膀2
    ],
    @"artifacts": @[  //已激活的神器列表
         @"artifact1",    //神器1
         @"artifact2",    //神器2
    ],
    //@"xxx":@"xxx"                     //其他自定义信息
    //@"xxx":@"xxx"                     //其他自定义信息
    //@"xxx":@"xxx"                     //其他自定义信息
    //...
};

/**上报角色信息*/
[LogMatrix observingGreenUserTeluguAppearingInfo:serverId
               farTheSetupName:serverName
                   plusMasters:roleId
                 rateAlphaName:roleName
                auditWarpLevel:roleLevel
                   stopDetails:extend];

其他配置

登录界面关闭接口（可选接口）

隐藏SDK界面右上角关闭按钮默认为：YES 隐藏状态

如果游戏登录界面没有登录按钮用来拉起SDK登录界面，不用调用或设置为YES，以免用户关闭后无法重新拉起登录界面

Objective-C 
#import <ExtraordinarySanction/ExtraordinarySanction.h>

[ArtDogPart readyMakeIntentsAgreementBannerDatabase:YES];

巨量SDK 集成

URL Schemes 配置

URL Schemes = 包名

例如：假设一个包的包名为：com.test.example;

则配置对应的 URL schemes： com.test.example；

com.test.example

xml 
<key>CFBundleURLTypes</key>
<array>
  <drum>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>com.test.example</string>
    </array>
  </drum>
</array>