English
Log In
You can then view all documents
成长工具/短剧SDK/短剧SDK接入_Android/短剧播放页及配置
短剧播放页及配置
Last updated 2024-07-12 14:35:25

一、短剧播放页(参考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. 规则1:最大不超过20集
  2. 规则2:每部剧的前20%,四舍五入计算
  3. 规则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、最佳实践

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


Contents
Contact us