安卓接入文档
SDK接入说明 统计SDK接入
iOS接入文档
SDK接入说明 统计SDK接入
PC端接入文档
PC SDK接入说明
服务端接入文档
SDK服务端接入说明 GM功能接入说明 附录-基础码表 附录-错误码表
数据接入文档
SDK打点接入 服务端打点接入 游戏快照接入

依游越狱SDK接入说明

1.接入须知

1.接入龙图iOSSDK的游戏及应用的iOS客户端开发者。
2.使用此文档内接口，需要先接入龙图iOSSDK(详情查看龙图iOSSDK文档)。
3.接入龙图iOSSDK后，需要配置依游SDK需要的依赖库。

注：本文为依游 iOS终端SDK接入教程，只涉及SDK的使用方法，默认读者已经熟悉Xcode开发工具的基本使用方法，以及具有一定的编程知识基础等。注意：在接入EUSDK前，跟EUSDK对接方确定给定的参数是否属于测试渠道的参数。

1.0 开发要求


  • iOS 9.0 及以上版本

  • XCode 13 及以上版本

    • 1.1 申请你的AppID

    1. <key>EUSDK</key>
    2.     <dict>
    3.         <key>Channel</key>
    4.         <string>"填入渠道提供的参数"</string>
    5.         <key>ChannelName</key>
    6.         <string>ceshi</string>
    7.         <key>EUAppId</key>
    8.         <string>"填入渠道提供的参数"</string>
    9.         <key>EUAppKey</key>
    10.         <string>"填入渠道提供的参数"</string>
    11.         <key>EUServerUrl</key>
    12.         <string>https://api.eusdk.com</string>
    13.         <key>Plugins</key>
    14.         <array>
    15.             <dict>
    16.                 <key>CName</key>
    17.                 <string>ceshi</string>
    18.             </dict>
    19.         </array>
    20.     </dict>
    21. 以上参数以我司提供的参数文档为准，没有提供的参数保持不变
    22. 如果是需要上架appstore的正版游戏，请联系EUSDK
    23. 以上参数格式可以参考demo

    提供的测试渠道参数格式如下:
    1、EU_APPID: xxxx
    2、EU_APPKEY: xxxxxxxxxxx
    3、EU_Channel: xxxxxxx
    4、服务端appSecret: xxxxxx(服务端用,可忽略)
    将提供参数替换info.plist对应的值
    注：不需要去修改ChannelName, CName

    1.2 下载SDK包和示例Demo

    下载对应demo

    1.3 开发环境配置

    1.3.1 framework导入

    需要引入的系统库
    库名称 SDK 备注
    libc++.tbd
    libz.tbd
    libsqlite3.tbd
    CoreTelephony.framework
    SystemConfiguration.framework
    Security.framework
    libLT_EUSDK.a
    EUSDKCore.framework

    *EUSDK需要在Framework选择 embed&sign

    EUSDK 要加入在 Embed Framework

    1.3.2 Build Setting设置

    在Target->Build Settings -> Other Linker Flags中添加-ObjC, 字母o和c大写。

    1.4 打包工具

    由于CP方的游戏资源不能对外公开，iOS版的正式渠道游戏接入，一般由EUSDK提供打包工具(已对接好的指定渠道SDK资源包)，由CP方接入EUSDK后，测试渠道调试正常，直接用打包工具出。
    打包工具和文档地址:https://www.yuque.com/ys_sdk/eusdkv2/nes935

    1.5 打开相册和相机权限

    NSPhotoLibraryUsageDescription
    App需要您的同意才能访问相册
    NSPhotoLibraryAddUsageDescription
    此 App 需要您的同意才能读取媒体资料库
    NSCameraUsageDescription
    App需要您的同意才能使用照相机

    1.6 打开后台通知和推送通知（可选）

    如果需要打开推送功能，配置Xcode
    选择target->Capabilities
    1，打开Background Modes，勾选Remote notifications
    2，打开Push Notifications

    2.SDK初始化

    接入龙图BaseSDK初始化即可

    3 功能接入

    3.1 生命周期 (必接)

    EUSDK 默认实现了UIApplicationDelegate的所有方法,请在您的应用内AppDelegate各个UIApplicationDelegate方法里调用龙图SDK的生命周期方法，
    如果需要打开推送功能(可选)，请在您的应用内AppDelegate各个UNUserNotificationCenterDelegate方法里调用龙图SDK的UNUserNotificationCenterDelegate方法
    具体可以参考demo.

    接口说明
    需结合龙图SDK文档综合接入
    OC 版本接口 

    2. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    3.     [[LTGameOCSDK shareInstance] LTSDKApplication:application didFinishLaunchingWithOptions:launchOptions];
    4.  return YES;
    5. }
    7. - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{
    8.     [[LTGameOCSDK shareInstance] LTSDKApplication:application didRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
    9. }
    11. - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error{
    12.     [[LTGameOCSDK shareInstance] LTSDKApplication:application didFailToRegisterForRemoteNotificationsWithError:error];
    13. }
    15. - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    16.     [[LTGameOCSDK shareInstance] LTSDKApplication:application didReceiveRemoteNotification:userInfo fetchCompletionHandler:completionHandler];
    17. }
    19. - (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    20.     [[LTGameOCSDK shareInstance] userNotificationCenter:center willPresentNotification:notification withCompletionHandler:completionHandler];
    21. }
    23. - (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
    24.     [[LTGameOCSDK shareInstance] userNotificationCenter:center didReceiveNotificationResponse:response withCompletionHandler:completionHandler];
    25. }
    27. - (void)applicationWillResignActive:(UIApplication *)application {
    28.     [[LTGameOCSDK shareInstance] LTSDKApplicationWillResignActive:application];
    29. }
    31. - (void)applicationDidEnterBackground:(UIApplication *)application {
    32.     [[LTGameOCSDK shareInstance] LTSDKApplicationDidEnterBackground:application];
    33. }
    35. - (void)applicationWillEnterForeground:(UIApplication *)application {
    36.     [[LTGameOCSDK shareInstance] LTSDKApplicationWillEnterForeground:application];
    37. }
    39. - (void)applicationDidBecomeActive:(UIApplication *)application {
    40.     [[LTGameOCSDK shareInstance] LTSDKApplicationDidBecomeActive:application];
    41. }
    43. - (void)applicationWillTerminate:(UIApplication *)application {
    44.     [[LTGameOCSDK shareInstance] LTSDKApplicationWillTerminate:application];
    45. }
    47. - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    48.     return [[LTGameOCSDK shareInstance] LTSDKApplication:application handleOpenURL:url];
    49. }
    51. - (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    52.     return [[LTGameOCSDK shareInstance] LTSDKApplication:application openURL:url options:options];
    53. }
    55. - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    56.     return [[LTGameOCSDK shareInstance] LTSDKApplication:application openURL:url sourceApplication:sourceApplication annotation:annotation];
    57. }
    59. - (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window {
    60.     return [[LTGameOCSDK shareInstance] LTSDKApplication:application supportedInterfaceOrientationsForWindow:window];
    61. }

    C++版本接口

    2. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    3.     LTGameSDK::GetInstance().ApplicationDidFinishLaunchingWithOptions(application, launchOptions);
    5.     return YES;
    6. }
    8. - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{
    9. LTGameSDK::GetInstance().DidRegisterForRemoteNotificationsWithDeviceToken(application, deviceToken);
    10. }
    12. - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error{
    13.     LTGameSDK::GetInstance().DidFailToRegisterForRemoteNotificationsWithError(application, error);
    14. }
    16. - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    17.     LTGameSDK::GetInstance().DidReceiveRemoteNotificationAndFetchCompletionHandler(application, userInfo, completionHandler);
    18. }
    20. - (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    21.     LTGameSDK::GetInstance().UserNotificationCenterWillPresentNotificationWithCompletionHandler(center, notification, completionHandler);
    22. }
    24. - (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
    25.     LTGameSDK::GetInstance().UserNotificationCenterDidReceiveNotificationResponseWithCompletionHandler(center, response, completionHandler);
    26. }
    28. - (void)applicationWillResignActive:(UIApplication *)application {
    29.     LTGameSDK::GetInstance().ApplicationWillResignActive(application);
    30. }
    32. - (void)applicationDidEnterBackground:(UIApplication *)application {
    33.     LTGameSDK::GetInstance().ApplicationDidEnterBackground(application);
    34. }
    36. - (void)applicationWillEnterForeground:(UIApplication *)application {
    37.     LTGameSDK::GetInstance().ApplicationWillEnterForeground(application);
    38. }
    40. - (void)applicationDidBecomeActive:(UIApplication *)application {
    41.     LTGameSDK::GetInstance().ApplicationDidBecomeActive(application);
    42. }
    44. - (void)applicationWillTerminate:(UIApplication *)application {
    45.     LTGameSDK::GetInstance().ApplicationWillTerminate(application);
    46. }
    48. - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    49.     return LTGameSDK::GetInstance().HandleOpenURL(url);
    50. }
    52. - (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    53.     return LTGameSDK::GetInstance().HandleOpenURL(app,
    54.                                               url,
    55.                                               [options valueForKey:@"UIApplicationOpenURLOptionsSourceApplicationKey"],
    56.                                               [options valueForKey:@"UIApplicationOpenURLOptionsAnnotationKey"]);
    57. }
    59. - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    60.     return LTGameSDK::GetInstance().HandleOpenURL(application, url, sourceApplication, annotation);
    61. }
    63. - (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window {
    64.     return LTGameSDK::GetInstance().ApplicationSupportedInterfaceOrientationsForWindow(application, window);
    65. }

    3.2展示闪屏

    EUSDK会根据您要对接的渠道,提供能否显示闪屏功能,请根据API返回值自行判断处理渠道是否支持闪屏，该接口在初始化之后调用。

    接口说明

    1. c++接口
    2. //展示闪屏,返回NO表示渠道不支持
    3.     bool showSplash();
    5. oc接口
    6. //展示闪屏,返回NO表示渠道不支持
    7. - (BOOL)LTSDKShowSplash;

    3.3 隐藏闪屏

    接口说明

    1. c++接口
    2. //隐藏闪屏,,返回NO表示渠道不支持
    3.     bool dismissSplash();
    5. oc接口
    6. //隐藏闪屏,,返回NO表示渠道不支持
    7. - (BOOL)LTSDKDismissSplash;

    4 常见问题

    https://www.yuque.com/ys_sdk/eusdkv2/qpifdu

上海中清龙图软件有限公司

沪ICP备16008233号-4 京公网安备 11010502046250号