中文
登录
后可查看全部文档
成长工具/内容输出/内容输出对接文档/内容输出接入_Android /集成文档
集成文档
最近更新 2023-05-24 11:33:16

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. (已经通过POM依赖引入,开发者无需手动引入)RangersAppLog:日志上报
  2. 穿山甲sdk:商业化变现(具体接入详见官方文档),以赋能平台生成的maven命令为准

注: 如果您已经接入过这两个库无需重复申请和接入。

  1. 重要: 请自查是否单独接入过applog,是否单独申请过火山引擎平台的appid,是否接入穿山甲内容输出其他方向;如有上述情况,请和技术支持同学联系
  2. 这两个sdk必须提前初始化,否则内容合作sdk不能正常工作
  3. RangersAppLog如果您不想自己初始化可以交给我们来进行初始化,具体详见下面的初始化参数
  4. 为避免RangersApplog引起合规问题,请注意:
  • ① 若您选择自行初始化RangersApplog,设置InitConfig.setAutoStart(boolean)时,若用户已同意「用户隐私协议」,传true;若用户还未同意,传false,后续等用户同意协议后,请务必调用Applog.start()方法!
  • ②若您选择交给我们进行初始化。若用户已经同意用户协议,在流媒体SDK初始化之后,请务必调用Applog.start()方法;若用户还未同意用户协议,等用户同意之后,再调用Applog.start()方法!

1.1.3 so库说明

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

1.1.4 混淆说明

如果您接入了类似ResGuard的资源混淆框架,需要将*.txt(详见本文末尾)中的资源都加入到这类框架的白名单中,当你接入的版本<3700时,使用“keep_res.txt”,接入的版本>=3700时,使用“keep_res_new.txt”

1.2 安装sdk

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

1.2.1 自动集成

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

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

1.2.1 初始化监听器

初始化监听器用来监听初始化是否成功。这个参数不是必须的:

  1. 如果您的初始化没有放到application,请确保使用时初始化已经成功。初始化失败,可以再次 调用初始化接口(建议最多不要超过3次)
  2. 如果您的初始化在application,可以忽略该初始化接口

1.2.2 配置参数说明

1.2.2.1 DPSdkConfig参数说明

1.2.2.2 IDPPrivacyController参数说明

注意:隐私控制器,一般可以忽略该配置

1.2.2.3 IDPToastController参数说明

1.2.2.4 DPUpdate说明(个性化开关)

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

1.2.3 其他配置说明

  1. 建议在接入调试时打开setDebug(true),流媒体SDK会尽力帮您检查参数是否缺失,并给出toast提示
  2. 在使用内容合作sdk尽量保证已获取到权限:文件读写权限、read_phone权限、地理位置权限
  3. 混淆配置已经打入aar中,不需要做额外处理
  4. so库支持的架构平台根据您app本身支持的架构配置即可,目前内容合作sdk支持所有架构

2.SDK错误码

错误码 说明

3.常见问题

  • 接入版本号小于等于0911以下,需要自行添加混淆,否则影响日志上报。其他版本不需要添加 混淆规则:
  • 系统自带fragment(android.app.Fragment)支持,要求版本不低于1.9.0.0
  • 使用androidx报错

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

keep_res.txtkeep_res.txt
14.38 KB
keep_res_new.txtkeep_res_new.txt
1.02 KB



本篇目录
联系我们