YSDK下载

目录


1. 下载YSDK

当SDK相关的权限都已经OK了以后,应用开发者可以在此处下载SDK进行集成。

SDK名称 使用范围 更新日期 下载地址 版本主要更新内容
YSDK_Android_1.6.3 联运网游、单机 2020-7-23 点击下载 1. 增加实名认证、未成年时长防沉迷和支付限制功能

2. 优化悬浮球体验,支持全屏边界吸附和关闭体验优化,降低用户打扰和误触概率
3. 已知bug修复,稳定性优化
4. 增加游戏服务器信息上报能力,用于对用户精细化运营,提升运营效率


点击版本历史了解更多内容


注:目前官网版本不包含64位系统和x86架构的so,如果需要支持需要单独找YSDK技术支持获取(微信公众号“应用宝官方发布”输入人工咨询)

2. 包内容说明

YSDK的发布包(zip)主要包含两个重要部分, SDK库和YSDKDemo。前者为YSDK库,后者YSDK接口的使用示例。具体内容如下:

YSDK_Android_*
    │
    ├─── README.html :关于YSDK的简单介绍说明
    |
    ├─── YSDK-AS :YSDK基于Android Studio的版本库及对应demo
    │       │
    │       ├─── YSDK_Android_*.aar :YSDK在基于Android Studio的项目中使用的SDK库
    │       │
    │       └─── YSDKDemo : YSDK基于Android Studio的Demo实现
    │
    ├─── YSDK-Eclipse :YSDK基于ADT(Eclipse)通过Android Library实现的版本库及对应demo
    │       │
    │       ├─── YSDKLibrary :YSDK版本库,是一个Android Library项目,游戏可以直接以Android Library的方式引用YSDK。
    │       │
    │       └─── YSDKDemo : YSDK基于ADT(Eclipse)的Demo实现
    │
    ├─── YSDKRes :YSDK相关的配置等文件集合
    │       │
    │       ├─── debug.keystore :YSDK的Demo使用的debug模式下的keystore
    │       │
    │       ├─── proguard-rules.pro :YSDK的代码混淆文件
    │       │
    │       ├─── MidasPay.zip :midas相关资源,用于游戏集成米大师,放在游戏的assets目录下。
    │       │
    │       ├─── ysdk.keystore :YSDK的Demo使用的release模式下的keystore
    │       │
    │       └─── ysdkconf.ini :YSDK相关的配置文件,放在游戏的assets目录下。
    │
    └─── YSDK_Android_*-debug-ysdktest.apk :YSDK可运行Demo包
	

注意事项
(1) 1.虽然版本包里面提供了YSDK的debug和release的keystore,但是目前YSDK的Demo仅使用了debug.keystore,因此游戏在运行YSDK的demo时请使用debug.keystore。
(2) 使用ADT(Eclipse)进行开发的项目,建议使用Android Library的方式引用YSDK。
(3) SDK 从1.2.0版本开始引入资源文件、同时调整优化了错误码,建议使用1.2.0以下版本的游戏在升级SDK版本时要重点关注。
(4) YSDK 从1.2.2版本开始使用Midas集成版,该版本不再需要腾讯充值APK,不过继承中增加了资源文件,游戏升级时需要注意。

3. YSDK1.6.3 接入说明

版本更新说明
•增加实名认证、未成年时长防沉迷和支付限制功能( (接入方式参见YSDK 防沉迷能力接入技术文档) )
•优化悬浮球体验,支持全屏边界吸附和关闭体验优化,降低用户打扰和误触概率
•增加游戏服务器信息上报接口,用于对用户精细化运营,提升运营效率(使用方式见区服信息上报接口使用方式
•已知 bug 修复,稳定性优化

接入说明
•Step 1.更新 YSDK 到 1.6.0 并完成标准接入,首次接入参考官网 wiki YSDK接入流程以及对应 YSDKDemo
•Step 2.通过默认 aar 方式接入,Eclipse 不再提供支持-需自行解包更新 so 库(jni 包内)、jar、资源文件(res 包内)、AndroidManifest 文件(本次均涉及需要特别注意)
•Step 3.更新混淆规则
•Step 4.参考接入 Demo 检查 Manifest 文件,比对检查相关 provider、service、以及打开 Http 通道的访问能力 重点检查
打开高版本 Android http 通道访问能力

 
<uses-library android:name="org.apache.http.legacy"
android:required="false"/>
android:usesCleartextTraffic="true"


打开 fileprovider 支持应用安装

 
<provider
android:name="com.tencent.ysdk.framework.web.YYBInstallFile
Provider"
android:authorities="com.tencent.tmgp.游戏实际包
名.installfileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/com_tencent_ysdk_fileprovider_path"
/>
</provider>

其中 『com.tencent.tmgp.游戏实际包名』需要改为当前游戏实际包名


Support 包依赖处理
新版本的 YSDK 使用到了 androidx 的一些 supprt 依赖:androidx.core.content.FileProvider 和androidx.localbroadcastmanager.content.LocalBroadcastManager,如果接入方本身使用的 support 依赖不是 androidx 系列的,则需要把这两个资源单独打进应用中, 压缩包内提供了这两个依赖包的剥离版本(androidx.zip 内)可供选择接入。将 androidx.zip 解压后,放到 java 目录下(保证两个文件的引用路径不要改变,LocalBroadcastManager.java 路径:androidx.localbroadcastmanager.content; FileProvider.java 路径:androidx.core.content)。
YSDKjierushuoming-003.png

如果出现 annotation 注解引用不到的问题,可以替换成游戏自身支持的 annotation 注解引用或者在游戏工程内加入androidx.annotation 的依赖。
YSDKjierushuoming-005.png

接入注意事项
1. 动态授权处理注意需保证在进入 YSDK 生命周期前完成,否则可能造成应用统计数据异常
2. 非 YSDKAPI 以及 YSDKCallBack 外的接口属于内部接口,游戏应避免调用造成 YSDK 生命周期以及票据异常,后续版本将逐步停止非必要接口对外暴露

区服信息上报接口使用方式:
接口:YSDKApi. reportGameRoleInfo(String zoneId, String zoneName, String roleId,String roleName, long roleCTime, long roleLevel,long roleLevelMTime, HashMap<String,String> extraData)
参数说明:

字段名 字段类型 是否为空 字段描述 提交时机
zoneId string 必填 区服 ID,一个服务器对应一个 ID,长度不超过 50 1、用户登录游戏成功后创建角色或使用已存在的角色进入游戏后调用

2、当用户的角色等级发生变化后调用(注:必填参数必须传真实数据)

zoneName 区服名称,要求与游戏界面展示的服务器名保持一致,长度不超过50
roleId 角色 ID,一个角色同一个服 ID 保持唯一,长度不超过 50
roleName 角色昵称,长度不超过 50
roleCTime long 角色创建时间(单位:秒 即10 位数),必须传服务器时间
roleLevel 角色等级级,如游戏存在转生,转职等,等级需累加,长度不超过10
roleLevelMTime 可选 角色等级变化时间(单位:秒 即 10 位数),必须传服务器时间,没有可传-1
extraData HashMap<String,String> 可选 扩展字段,没有可传 null

4. androidx依赖包下载

androidx依赖包下载

以上信息是否解决您的问题?

Copyright © 1998 - 2020 Tencent. All Rights Reserved.

腾讯公司 版权所有

返回顶部