Flutter数字版权管理插件pallycon_drm_sdk的使用

一个为开发媒体服务应用而设计的 Flutter 插件 pallycon_drm_sdk，支持在 Android 和 iOS 上轻松应用多 DRM（Android: Widevine, iOS: FairPlay）。请参阅以下链接以获取详细信息。

支持环境

• Android 5.0 (Lollipop) 及以上版本，且 targetSdkVersion 31 或更高
• iOS 12.0 及以上版本
• 该 SDK 在 Android 上支持 ExoPlayer 版本 2.18.1

重要事项

• 若要使用该 SDK 开发，您必须首先注册 PallyCon 管理站点并获得站点 ID。

SDK 使用

要将 PallyConDrmSdk 添加到您的 Flutter 应用中，请阅读安装说明。以下是 PallyConDrmSdk 正常工作所需的 Android 和 iOS 属性。

Android

编译 SDK 版本

确保在 “android/app/build.gradle” 文件中设置 compileSdkVersion。

android {
  compileSdkVersion 34

  ...
}

权限

SDK 中使用了以下 4 项与用户权限有关的内容。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

您可以在 android/build.gradle 文件中的 repositories 块中添加 Maven 仓库配置，如下所示：

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://maven.pkg.github.com/inka-pallycon/pallycon-widevine-android-sdk")
            credentials {
                username = "GitHub user id"
                password = "GitHub access token"
            }
        }
    }
}

iOS

PallyCon DRM SDK Flutter 使用 PallyConFPSSDK。PallyConFPSSDK 需要通过 cocoapods 下载。

SDK 要求

• 最低支持版本：11.2

初始化

PallyConDrmSdk.initialize(siteId);

设置事件

注册 SDK 中发生的事件。

PallyConDrmSdk.onPallyConEvent.listen((event) {
    var downloadState = DownloadStatus.pending;
    switch (event.eventType) {
        case PallyConEventType.prepare:
          // 准备阶段
          break;
        case PallyConEventType.complete:
          // 下载完成时调用
          break;
        case PallyConEventType.pause:
          // 下载过程中止时调用
          break;
        case PallyConEventType.download:
          // 下载开始时调用
          break;
        case PallyConEventType.contentDataError:
          // 传递给 SDK 的参数发生错误时调用
          break;
        case PallyConEventType.drmError:
          // 许可证错误时调用
          break;
        case PallyConEventType.licenseServerError:
          // 从许可证服务器返回错误时调用
          break;
        case PallyConEventType.downloadError:
          // 下载过程中发生错误时调用
          break;
        case PallyConEventType.networkConnectedError:
          // 网络错误时调用
          break;
        case PallyConEventType.detectedDeviceTimeModifiedError:
          // 设备时间被强制修改时调用
          break;
        case PallyConEventType.migrationError:
          // SDK 迁移失败时调用
          break;
        case PallyConEventType.unknown:
          // 发生未知错误时内部调用
          break;
  }
  // 内容状态
}).onError((error) {
  // 错误处理
});

下载时注册监听器以了解当前已下载数据的大小。

PallyConDrmSdk.onDownloadProgress.listen((event) {
    // event.url 是 URL
    // event.percent 是下载百分比
});

获取内容下载状态

获取内容的当前下载状态。

PallyConDownloadState downloadState =
        await PallyConDrmSdk.getDownloadState(PallyConContentConfiguration);
    switch (downloadState) {
      case PallyConDownloadState.DOWNLOADING:
        break;
      case PallyConDownloadState.PAUSED:
        break;
      case PallyConDownloadState.COMPLETED:
        break;
      default:
        break;
    }

下载

描述内容下载过程所需的 API。

// 开始下载
PallyConDrmSdk.addStartDownload(PallyConContentConfiguration);

// 停止下载
PallyConDrmSdk.stopDownload(PallyConContentConfiguration);

// 取消下载
PallyConDrmSdk.cancelDownloads();

// 暂停下载
PallyConDrmSdk.pauseDownloads();

// 恢复下载
PallyConDrmSdk.resumeDownloads();

移除许可证或内容

移除已下载的许可证和内容。

// 移除已下载的内容
PallyConDrmSdk.removeDownload(PallyConContentConfiguration);

// 移除内容的许可证
PallyConDrmSdk.removeLicense(PallyConContentConfiguration);

释放

结束使用 SDK 时调用。

PallyConDrmSdk.release();

示例代码

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:pallycon_drm_sdk/pallycon_drm_sdk.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'PallyConDrmSdk';
  var _pallyConDrmSdk = PallyConDrmSdkPlatform.instance;

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息异步，因此我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    String platformVersion = "None";
    // 平台消息可能失败，因此我们使用 try/catch PlatformException。
    // 我们还处理消息可能返回 null 的情况。
    try {
      // await PallyConDrmSdkPlatform.instance.initialize();
      _pallyConDrmSdk.onPallyConEvent.listen((message) {
        setState(() {
          _platformVersion = message.toString();
        });
      });

      await _pallyConDrmSdk.initialize("DEMO");

      var config = PallyConContentConfiguration(
        "bunny",
        "https://contents.pallycon.com/DEMO/app/big_buck_bunny/dash/stream.mpd",
        token: "eyJkcm1fdHlwZSI6IldpZGV2aW5lIiwic2l0ZV9pZCI6IkRFTU8iLCJ1c2VyX2lkIjoidGVzdFVzZXIiLCJjaWQiOiJkZW1vLWJiYi1zaW1wbGUiLCJwb2xpY3kiOiI5V3FJV2tkaHB4VkdLOFBTSVljbkp1dUNXTmlOK240S1ZqaTNpcEhIcDlFcTdITk9uYlh6QS9pdTdSa0Vwbk85c0YrSjR6R000ZkdCMzVnTGVORGNHYWdPY1Q4Ykh5c3k0ZHhSY2hYV2tUcDVLdXFlT0ljVFFzM2E3VXBnVVdTUCIsInJlc3BvbnNlX2Zvcm1hdCI6Im9yaWdpbmFsIiwia2V5X3JvdGF0aW9uIjpmYWxzZSwidGltZXN0YW1wIjoiMjAyMi0wNi0xOVQyMzo0NjoyOFoiLCJoYXNoIjoid3dWSFVhNnRNT1BUUmZmNkRWZUVua0Z0cWMvMkJBRkpGUzU1aE5iNkp2ND0ifQ==",
        licenseUrl: "https://license.pallycon.com/ri/licenseManager.do",
      );
      _pallyConDrmSdk.addStartDownload(config);

    } on PlatformException catch(e) {
      _platformVersion = e.toString();
    }

    // 如果小部件在异步平台消息飞行时从树中删除，我们希望丢弃回复而不是调用
    // setState 更新我们的不存在的外观。
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('运行于: $_platformVersion\n'),
        ),
      ),
    );
  }
}