🎬 短剧模块
2.0: 对应 2.0.0 纯短剧契约。pub.dev 当前仍提供 1.0.3;依赖尚未升级时请切换到 1.x 文档。

平台边界

短剧预览卡片只在 Android 官方 SDK 中提供。iOS 创建 DramaCardNativeView 会在进入 MethodChannel 前抛出 UnsupportedError,不会展示占位视图或返回伪成功。

使用方式

卡片需要有界宽度。PanGrowth 2.8.0.2 的原生画面比例固定为 9:16,插件会在 容器完成布局后把实际宽度转换为 dp,并按可用宽高完整容纳原生 View,不再使用 厂商默认的 100dp。旋转、分屏或窗口尺寸变化导致 SDK 请求宽度变化时,插件会 销毁旧组件并按新尺寸重建;旧异步加载结果不会重新覆盖当前卡片。

final controller = DramaCardController();

DramaCardNativeView(
  controller: controller,
  config: const DramaCardConfig(
    dramaId: 1001,
    muted: true,
    autoplay: true,
    looping: true,
  ),
  listener: DramaCardListener(
    onClicked: (event) {
      openDramaPlayer(event.dramaId);
    },
  ),
)
await controller.play();
await controller.pause();
await controller.setMuted(false);
await controller.reload();

卡片进入可见区域时才应播放;离屏、进入后台和页面销毁时应暂停并释放资源。

需要进一步协助?

与 LightCore 技术顾问沟通,获取商业化策略与集成支持。