1. SDK接入

1.1 依赖说明

1.1.1 安卓sdk依赖

内容合作sdk支持安卓版本：21~29

依赖安卓内部库：support-v4，建议版本：24以上

依赖安卓内部库：recyclerview-v7，建议版本：24以上

如果接入小视频3100、3200版本需要依赖安卓内部库：constraint-layout，指定版本：1.1.2，具体方式如下(androidx和support根据具体使用环境使用其中一个即可)：

1.1.2 外部库依赖

内容合作sdk需要依赖两个外部库：

1. RangersAppLog：日志上报（通过Maven接入内容SDK时会自动引入，开发者无需手动引入）
2. 穿山甲sdk：商业化变现（具体接入详见官方文档），①穿山甲sdk需要开发者参考平台接入文档进行手动接入；②内容SDK依赖穿山甲sdk中的广告功能进行变现，两者是独立的两个SDK

注： 如果您已经通过其他途径接入过这两个库无需重复申请和接入。

重要：

① 请自查是是否单独申请过火山引擎平台的appid/单独接入过applog，即若其他业务侧生成的appid和穿山甲侧不同，开发者可以自行处理applog相关逻辑；

② 若开发者有接入穿山甲赋能输出其他方向，需确保其初始化时机早于内容sdk，否则会导致内容合作sdk不能正常工作&媒体自己的埋点失效；

使用 Applog.init(Context, InitConfig) 初始化 applog

③ 若开发者没有以上两种使用场景，即只接入内容SDK，则不需要单独初始化applog，强烈建议自行接入applog的媒体升级到3901及以上版本，具体详见下面的1.3初始化SDK；

1.1.3 so库说明

内容合作sdk内置点播相关的so库，只支持armeabi-v7a架构和arm64-v8a架构。

1.1.4 混淆说明

如果您接入了类似ResGuard的资源混淆框架，需要将对应sdk版本Demo中的keep_res_xxxx.txt中的资源都加入到这类框架的白名单中（xxxx为对应的赋能版本号），当前最新版本的keep_res.txt如下

1.2 安装sdk

目前支持自动集成和手动集成两种方式，如果您使用Gradle编译，建议您使用自动接入方式配置库文件。

1.2.1 自动集成

打开project级别的build.gradle，添加如下两个仓库

在app module的build.gradle文件的dependencies中添加：

在Application的Module中添加命令依赖gradle脚本：

AndroidManifest.xml配置：在app module的AndroidManifest.xml文件中添加：

1.3 初始化SDK

重要：小视频2600版本开始，新客户接入时需要从穿山甲平台获取配置文件，在内容输出->内容管理模块找到对应的应用，点击「下载SDK参数配置」，然后将JSON配置文件拷贝到项目的assets文件夹下。

重要：开发者需要自行接入并初始化穿山甲SDK，并在穿山甲Sdk初始化完成回调中初始化内容SDK。一定要注意初始化顺序：

① 在穿山甲广告SDK初始化成功的回调中(InitCallback.success)初始化内容SDK；

初始化成功的回调：穿山甲版本 5600 以下在 TTAdSdk.init() 方法中，5600 及以上版本在 TTAdSdk.start() 方法中

② 其他聚合 SDK 需自行判断穿山甲SDK初始化完成状态，在初始化成功后再初始化内容SDK

1.4 启动SDK服务

在用户同意隐私权限后，使用SDK具体场景（如创建沉浸式小视频），必须先调用init接口，然后调用start接口，并在start结果成功回调之后才能使用具体的场景功能启动，建议在较早的时间启动Sdk

方式如下：

建议在创建具体业务前判断内容SDK启动状态，如下（可参考demo具体使用方式）

启动监听器用来监听SDK服务是否启动成功

• isSuccess=true表示启动服务成功
• 启动服务失败时，可以再次调用启动服务接口（建议最多不要超过3次)

初始化配置参数说明

1.4.1 DPSdkConfig参数说明

1.4.2 IDPPrivacyController参数说明

隐私信息控制开关

1.4.3 IDPToastController参数说明

1.4.4 DPUpdate说明（个性化开关）

1.4.5 文章详情列表字体大小样式说明

1.4.6 其他配置说明

1. 建议在接入调试时打开setDebug(true)，流媒体SDK会尽力帮您检查参数是否缺失，并给出toast提示
2. 在使用内容合作sdk尽量保证已获取到权限：文件读写权限、read_phone权限
3. 混淆配置已经打入aar中，不需要做额外处理
4. so库支持的架构是armeabi-v7a和armeabi-v8a两种

2.SDK错误码

错误码说明

3.常见问题

• 接入版本号小于等于0911以下，需要自行添加混淆，否则影响日志上报。其他版本不需要添加 混淆规则：

• 系统自带fragment(android.app.Fragment)支持，要求版本不低于1.9.0.0
• 使用androidx报错

解决方案：app级别的build.gradle下添加依赖