DramaPlayerController class

短剧播放器控制器

封装 playerId 管理和播放器控制方法，简化使用。 配合 DramaPlayerNativeView 使用，自动处理播放器生命周期。

使用示例：

final controller = DramaPlayerController();

DramaPlayerNativeView(
  config: DramaPlayerConfig(...),
  controller: controller,
)

// 控制播放
await controller.setSpeed(150); // 1.5x 倍速
await controller.openDramaGallery();

Constructors

DramaPlayerController()

Properties

hashCode → int
The hash code for this object.
no setterinherited
isReady → bool
播放器是否已准备就绪
no setter
playerId → String?
获取播放器ID（如果需要直接访问）
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

cancelUnlock() → Future<bool>
取消解锁（Common模式下使用自定义弹窗时调用）
confirmUnlock() → Future<bool>
确认解锁（Common模式下使用自定义弹窗时调用）
dispose() → void
清除播放器ID（销毁时调用）
enterPlayPage() → Future<Map<String, dynamic>>
进入播放页（iOS专用）
getCurrentEpisode() → Future<Map<String, dynamic>>
获取当前播放集数
getCurrentIndex() → Future<Map<String, dynamic>>
获取当前播放索引（当前集数在列表中的位置） 返回 Map 包含 'currentIndex' 字段
initialize(String playerId) → void
初始化播放器ID（由 Widget 内部调用）
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
openDramaGallery() → Future<bool>
打开选集面板
openMoreDialog() → Future<Map<String, dynamic>>
打开更多弹窗（举报、设置等）
refresh() → Future<Map<String, dynamic>>
刷新播放页
seekTo(int duration) → Future<Map<String, dynamic>>
跳转到指定播放位置 duration 跳转位置（毫秒）
setCurrentEpisode(int episode) → Future<Map<String, dynamic>>
设置当前播放集数 episode 集数（从1开始）
setCustomAdOnReward({required bool verify, Map<String, dynamic>? extraData}) → Future<bool>
通知SDK自定义广告奖励结果 verify 是否验证通过（广告播放完成） extraData 额外数据（如dramaId、episode等）
setCustomAdOnShow({String? cpm}) → Future<bool>
通知SDK自定义广告已开始展示 cpm 广告CPM，传'custom'表示自定义广告
setSpeed(int speed, {String scope = 'episode'}) → Future<bool>
设置播放倍速 speed 播放速度（100表示1.0x，150表示1.5x，200表示2.0x） scope 倍速作用范围，episode 表示当前集、drama 表示整部短剧
toString() → String
A string representation of this object.
inherited
unlockDrama({required int episodeId, required int lockSet, bool cancel = false}) → Future<bool>
解锁短剧 episodeId 集数ID lockSet 解锁集数 cancel 是否取消解锁

Operators

operator ==(Object other) → bool
The equality operator.
inherited