帮助中心

中文

后可查看全部文档

帮助文档

新手引导

合作注册

流量管理

开发测试

财务结算

业务规范

GroMore

AdSpark（增长参谋）

成长工具

成长工具/内容输出/内容SDK/内容SDK_Android/短剧接入_Android/短剧播放页及配置

短剧播放页及配置

最近更新 2025-01-13 15:16:21

一、短剧播放页（参考DramaDetailActivity）

1、加载播放页 Fragment

接入方可以调用DJXSdk.factory().createDramaDetail(DJXWidgetDramaDetailParams)来获取播放详情页fragment，将获取到的播放聚合页fragment放入到自己app中即可。

短剧播放页 demo入口：底部集合Tab -> 多媒体入口 -> 短剧 -> 自定义短剧详情页
必读：SDK已经封装了短剧播放的能力(不返回短剧videoUrl)，开发者只需调用 DJXWidgetDramaDetailParams.obtain(drama.id, drama.index, detailConfig) 将短剧id，指定播放集数，播放页配置config参数(调整播放页UI，自定义解锁逻辑等)传入即可获取播放详情页fragment，开发者将此fragment添加到app中即可实现短剧播放的能力，使用方式详见本

2、接口说明

2.1 获取组件工厂

复制

2.2 创建组件

复制

2.3 组件IDJXWidget说明

复制

2.4 组件参数DJXWidgetDramaDetailParams说明

复制

2.5 监听器IDJXDramaListener说明

复制

2.6 监听器 IDJXAdListener 说明

复制

二、短剧播放页配置【⚠️重要⚠️】

免费强规则：

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

规则1：最大不超过20集
规则2：每部剧的前20%，四舍五入计算
规则1和规则2满足其一均可。

解锁集数强校验：

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

1. 规则1：一个激励视频最多解锁10集

1、接口说明

1.1 解锁广告方式枚举 DJXDramaUnlockAdMode

复制

1.2 解锁信息物料 DJXDramaUnlockInfo

复制

1.3 解锁链路监听 IDJXDramaUnlockListener

复制

1.4 配置参数 DJXDramaDetialConfig

复制

1.5 自定义广告配置 IDJXDramaAdCustomProvider

短剧详情页支持插入draw广告，滑滑流和短剧详情页支持开发者自定义banner广告

1. 当前draw和banner仅支持自定义广告，使用方式只需要调用DJXDramaDetailConfig.adCustomProvider()。

2. draw广告插入位置说明：支持开发者透传位置数组，数组值表示随后插入一条广告(如2则在2之后插入一条)。

复制

1.6 自定义draw广告IDJXCustomView

复制

2、最佳实践

开发者需要关心 IDJXDramaUnlockListener 中的三个方法：unlockFlowStart，unlockFlowEnd，showCustomAd。
unlockFlowStart和unlockFlowEnd必须实现，含义为短剧解锁链路开始和结束，开发者需要将用户选择的解锁方法（DJXDramaUnlockInfo）通过 onConfirm回传。
如果用户取消解锁可以通过 onConfirm 回传 DJXDramaUnlockInfo.cancelUnlock = true通知 SDK
如果开发者希望自行出广告请实现 showCustomAd，具体实现查看IDJXDramaUnlockListener.CustomAdCallback
解锁时不确定设置的免费集数或者解锁集数时可以使用 IDJXService.verifyDramaParams 判断设置的参数是否为合法参数

复制

本篇目录