导入DRM Kit接口。
```
import { drm } from '@kit.DrmKit';
```
导入BusinessError模块抛出DRM Kit接口的错误码。
```
import { BusinessError } from '@kit.BasicServicesKit';
```
（可选）调用getMediaKeySystems，获取设备支持的DRM解决方案名称和唯一标识的列表。
```
const descriptions: drm.MediaKeySystemDescription[] = drm.getMediaKeySystems();
```
如果获取结果数组为空，说明该设备中不存在支持的DRM解决方案。

（可选）调用isMediaKeySystemSupported，查询设备是否支持对应DRM解决方案名称、媒体类型、安全保护级别的DRM解决方案。

const byName = drm.isMediaKeySystemSupported(DRM_SOLUTION_NAME);
// ...
const byMimeType = drm.isMediaKeySystemSupported(DRM_SOLUTION_NAME, MIME_TYPE);
// ...
const byLevel = drm.isMediaKeySystemSupported(
  DRM_SOLUTION_NAME, MIME_TYPE, drm.ContentProtectionLevel.CONTENT_PROTECTION_LEVEL_SW_CRYPTO);
// ...

如果查询结果为false，说明该设备不支持对应的DRM解决方案。

调用createMediaKeySystem，创建MediaKeySystem实例。
```
mediaKeySystem = drm.createMediaKeySystem(DRM_SOLUTION_NAME);
```
如果创建失败则返回undefined，说明该设备不支持该DRM解决方案。
（可选）调用on('keySystemRequired')，设置MediaKeySystem状态监听事件。

通过注册keySystemRequired回调函数监听设备DRM证书请求事件。该事件在需要设备DRM证书时触发，此时建议完成设备DRM证书请求与处理流程。
```
mediaKeySystem.on('keySystemRequired', (eventInfo: drm.EventInfo) => {
  console.info(`keySystemRequired extra:${eventInfo.extraInfo} data:${eventInfo.info}`);
  // 设备DRM证书请求与处理。
});
```
（可选）调用getCertificateStatus，获取设备DRM证书状态。
```
const certificateStatus = mediaKeySystem.getCertificateStatus();
```

（可选）调用generateKeySystemRequest和processKeySystemResponse，生成设备DRM证书请求与处理设备DRM证书响应。

如果设备DRM证书状态不是drm.CertificateStatus.CERT_STATUS_PROVISIONED，可以生成设备DRM证书请求，处理设备DRM证书响应。

const provisionRequest = await mediaKeySystem.generateKeySystemRequest();

// 将设备DRM证书请求返回的provisionRequest.data通过网络请求发送给DRM证书服务获取设备DRM证书响应，并处理。
const provisionResponse = new Uint8Array([0x00, 0x00, 0x00, 0x00]); // 设备DRM证书响应。
await mediaKeySystem.processKeySystemResponse(provisionResponse);

调用createMediaKeySession，创建MediaKeySession实例。

创建该DRM解决方案默认内容保护级别的MediaKeySession实例。
```
mediaKeySession = mediaKeySystem.createMediaKeySession();
```

（可选）设置MediaKeySession状态监听事件。

监听MediaKeySession实例的事件，包括媒体密钥请求事件、媒体密钥过期事件、媒体密钥有效期更新事件、媒体密钥变换事件等。

使用on('keyRequired')接口监听媒体密钥请求事件，此时建议完成媒体密钥请求与处理流程。

mediaKeySession.on('keyRequired', (eventInfo: drm.EventInfo) => {
  console.info(`keyRequired info:${eventInfo.info} extraInfo:${eventInfo.extraInfo}`);
  // 媒体密钥请求与处理。
});

使用on('keyExpired')接口监听媒体密钥过期事件。

mediaKeySession.on('keyExpired', (eventInfo: drm.EventInfo) => {
  console.info(`keyExpired info:${eventInfo.info} extraInfo:${eventInfo.extraInfo}`);
});

使用on('expirationUpdate')接口监听媒体密钥有效期更新事件。

mediaKeySession.on('expirationUpdate', (eventInfo: drm.EventInfo) => {
  console.info(`expirationUpdate info:${eventInfo.info} extraInfo:${eventInfo.extraInfo}`);
});

使用on('keysChange')接口监听媒体密钥变换事件。

mediaKeySession.on('keysChange', (keyInfo: drm.KeysInfo[], newKeyAvailable: boolean) => {
  for (let i = 0; i < keyInfo.length; i++) {
    console.info(`keysChange keyId:${keyInfo[i].keyId} value:${keyInfo[i].value}`);
  }
});

（可选）调用requireSecureDecoderModule，查询是否需要安全解码。

const needSecureDecoder = mediaKeySession.requireSecureDecoderModule(MIME_TYPE);

调用generateMediaKeyRequest和processMediaKeyResponse，生成媒体密钥请求与处理媒体密钥响应。

获取到DRM节目中的DRM信息时，可以生成媒体密钥请求，处理媒体密钥响应，以请求许可证完成DRM节目授权。

// 实际应用中initData应从媒体内容的PSSH box中提取。
const initData = new Uint8Array([0x00, 0x01, 0x02, 0x03]);
// 根据DRM解决方案要求设置可选数据的值。
const optionalData: drm.OptionsData[] = [{
  name: 'optionalDataName',
  value: 'optionalDataValue'
}];
const mediaKeyRequest = await mediaKeySession.generateMediaKeyRequest(
  MIME_TYPE, initData, drm.MediaKeyType.MEDIA_KEY_TYPE_ONLINE, optionalData);

// 将媒体密钥请求返回的mediaKeyRequest.data通过网络请求发送给DRM服务获取媒体密钥响应，并处理。
const mediaKeyResponse = new Uint8Array([0x00, 0x00, 0x00, 0x00]); // 媒体密钥响应。
const offlineMediaKeyId = await mediaKeySession.processMediaKeyResponse(mediaKeyResponse);

（可选）调用restoreOfflineMediaKeys，恢复离线媒体密钥。
```
await mediaKeySession.restoreOfflineMediaKeys(offlineMediaKeyId);
```
（可选）调用checkMediaKeyStatus，检查媒体密钥状态。
```
const keyStatus = mediaKeySession.checkMediaKeyStatus();
```

（可选）调用getOfflineMediaKeyIds获取离线媒体密钥标识列表，调用getOfflineMediaKeyStatus获取离线媒体密钥状态，调用clearOfflineMediaKeys删除离线媒体密钥。

媒体密钥标识用于对离线媒体密钥的管理。

const offlineMediaKeyIds = mediaKeySystem.getOfflineMediaKeyIds();
if (offlineMediaKeyIds.length > 0) {
  const offlineStatus = mediaKeySystem.getOfflineMediaKeyStatus(offlineMediaKeyIds[0]);
  mediaKeySystem.clearOfflineMediaKeys(offlineMediaKeyIds[0]);
}

销毁MediaKeySession实例。

完成加密媒体解密，MediaKeySession实例不再使用时，销毁MediaKeySession实例。
```
mediaKeySession.destroy();
```
销毁MediaKeySystem实例。

完成DRM功能使用，MediaKeySystem实例不再使用，销毁MediaKeySystem实例。
```
mediaKeySystem.destroy();
```

目录

数字版权保护(ArkTS)

开发步骤