中文
登录
后可查看全部文档
成长工具/内容输出/内容SDK/常见问题&排查指南/内容SDK常见问题
内容SDK常见问题
最近更新 2024-12-12 19:15:18

初始化/接入问题

Q:java.lang.IllegalArgumentException: secure_key must not be null, please check your config file!

A:json配置文件不是最新的,请前往穿山甲平台-内容输出模块下载接入应用最新的内容SDK 参数配置文件

Q:初始化异常 java.lang.IllegalArgumentException: config file must not be null, please check your config file!

A:1、检查json文件是否正确,如果是短视频sdk升级内容sdk的场景,需要从穿山甲平台重新下载json配置文件

2、检查json文件路径是否正确

3、json文件内容是否有修改

Q:初始化失败,获取token2失败

A:1、检查是否有修改系统时间

2、检查json文件是否正确

3、检查包名是否正确

4、检查sha1是否正确

5、是否接入短视频,如接入短视频检查初始化顺序(广告->短剧->短视频)

6、以上检查都没问题的话抓包一下 https://www.csjplatform.com/supportcenter/28180

Q:接入短剧和点播SDK冲突

A:SDK支持接入剔除点播的版本

Android:implementation 'com.pangle.cn:pangrowth-djx-sdk-lite:x.x.x.x'//短剧-去除点播SDK,以平台生成的版本号为准

iOS:pod 'Pangrowth', 'x.x.x.x', :subspecs => [ 'djx-lite' ]//短剧-去除点播SDK,以平台生成的版本号为准

Q:报错-2,msg = 数据解析异常

A:可以判断下非空类型,再做后续的处理

Q:是否支持Androidx

A:支持,开发者按照Andriodx官方文档去适配下即可

Q:IOS动态接入与静态接入的区别

A:动态接入app体积会更小, 而且可以做到动态库内容不需要重新编译即可获得最新功能,建议开发者通过动态的方式接入短剧,可以规避开发者本身有接入点播SDK或播放器能力导致的冲突问题

Q:广告SDK冲突导致编译不过

A:如下图所示:一般是开发者接入2个广告SDK版本导致的库冲突,内容SDK会依赖穿山甲广告SDK,所以平台生成的接入命令自带广告SDK,若开发者本身有接入穿山甲广告SDK/Gromore,则不需要重复导入


短剧解锁

Q:短剧解锁规则

A:免费强规则:

免费观看的定义:用户没有任何解锁动作的前提下,从第一集开始,免费连续观看多少集。

- 规则1:最大不超过20集

- 规则2:每部剧的前20%,四舍五入计算

- 规则1和规则2满足其一均可。

解锁集数强校验:

- 解锁定义:一个激励视频解锁多少集

- 规则1:一个激励视频最多解锁10集

Q:短剧解锁失败

A:可以看下unlockFlowEnd#UnlockErrorStatus,如果是广告相关的问题,在创建短剧播放页配置参数时设置广告监听「DJXDramaDetailConfig#adLIstener」,打印下onDJXAdRequestFail(广告请求失败)看看是否有错误信息返回,广告SDK常见填充失败参考https://www.csjplatform.com/supportcenter/5421

Q:是否可提前预加载解锁广告

A:SDK目前是支持连续观看多个广告来解锁的,实现方式请参考Demo


短剧播放问题

Q:没有返回短剧Url,怎么播放呢?

A:SDK已封装了播放能力,不返回短剧播放url,开发者只需要将播放免费集数、每次解锁集数、播放的短剧id等信息传给短剧播放页即可实现


数据相关问题

Q:如何获取短剧的业务和广告收益数据

A:目前短剧相关数据暂未做到平台披露

① 广告收益数据

    1. 封装模式下:开发者可根据短剧内相关代码位去查询
    2. 非封装模式下:广告代码位由开发者自行插入,开发者可自己根据所使用代码位进行查询

② 内容数据指标:当前未披露到平台上,建议开发者自己埋点进行查看


通用问题

Q:短剧的唯一标识?

A:短剧的id是短剧的唯一标识

Q:封面链接失效

A:确认是否是实时请求,数据有效时间为7天

Q:短剧观看过程中熄屏

A:在对应的activity中使用getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)即可实现

Q:短剧底部的进度条是否支持影藏、是否支持自定义样式

A:不支持隐藏和自定义播放条样式

Q:如何获取“热门短剧”和“精选短剧”内容

A:可以通过DJXDrama#levelLabels等级标签字段来判断短剧的质量,该字段是综合线上短剧表现筛选出来的潜力和数据表现都比较好的短剧内容

Q:如何将某部短剧置顶

A:开发者可以通过mTopDramaIds设置置顶短剧ID列表

Q:短剧是否有接口控制播放、暂停

A:暂时不支持,开发者可以在短剧播放、暂停回调里面做相应的处理

Q:短剧内容更新频次

A:短剧上新和下架没有固定时间,不建议开发者直接将短剧内容保存,可能会出现短剧内容无法播放影响用户体验的情况,建议开发者实时请求短剧信息进行播放;

Q:短剧内容通过什么协议下发到客户端的,支持 IPv6 吗?

A:是https协议下发的,支持ipv6

Q:是否支持支付/会员制/iap解锁链路?

A:不支持,目前只支持通过SDK广告或者自定义广告来解锁;

Q:聚合页是否支持分类和搜索能力

A:不支持,若开发者对短剧列表页的样式和功能有个性化诉求,可以通过内容SDK提供的接口获取短剧信息,然后自行绘制;

Q:是否支持分享短剧的能力

A:暂不支持

Q:是否支持横屏播放短剧

A:暂不支持


本篇目录
联系我们