目录

客户端关键接口说明

WisePlay DRM客户端接口按照第三方框架API实现,接口定义请直接参考MediaDrm、MediaCodec。

MediaDrm的关键接口包括:

openSession

getKeyRequest

provideKeyResponse

restoreKeys

queryKeyStatus

isCryptoSchemeSupported

MediaCodec的关键接口包括:

configure

dequeueInputBuffer

queueSecureInputBuffer

dequeueOutputBuffer

releaseOutputBuffer


创建MediaDrm对象

  1. 判断是否支持WisePlay DRM的UUID;

  2. 创建MediaDrm对象,传入WisePlay DRM的UUID, UUID是每种DRM类型的全球唯一标识,通过此UUID,可唯一确认DRM的类型,对于WisePlay DRM,UUID为:3d5e6d35-9b9a-41e8-b843-dd3c6e72c42c;

  3. 调用openSession方法打开一个会话;

     代码样例:

  1. UUID WISEPLAY_DRM_UUID = new UUID(0x3d5e6d359b9a41e8L, 0xb843dd3c6e72c42cL);
  2. if(MediaDrm.isCryptoSchemeSupported(WISEPLAY_DRM_UUID)){
  3.    MediaDrm mediaDrm = null;
  4.    try {
  5.        mediaDrm = new MediaDrm(WISEPLAY_DRM_UUID);
  6.        mediaDrm.openSession();
  7.    } catch (UnsupportedSchemeException e) {
  8.        e.printStackTrace();
  9.    } catch (ResourceBusyException e) {
  10.        e.printStackTrace();
  11.    } catch (NotProvisionedException e) {
  12.        e.printStackTrace();
  13.    }
  14. }

获取license

  1.创建MediaDrm对象并传入WisePlay DRM的UUID;

  2.调用MediaDrm的openSession方法打开一个会话并获取到sessionId;

  3.调用MeidaDrm的getKeyRequest 方法,获取License请求消息体的KeyRequest对象,传入的参数的说明如下:

  4.在线发送获取License请求,请求以POST方式发送给业务服务器,请求头的content-type头域设置为application/json,请求的消息体为第三步获取的KeyRequest 对象的getData方法获取到的数据;

  5.得到服务端响应后,将服务端透传的WisePlay DRM Server响应的内容,通过provideKeyResponse方法,传递给底层Plugin,传入的参数为:从服务端获取到的license数据的byte数组。

     代码样例:

  1. UUID WISEPLAY_DRM_UUID = new UUID(0x3d5e6d359b9a41e8L, 0xb843dd3c6e72c42cL);
  2. MediaDrm mediaDrm = null;
  3. try {
  4.    mediaDrm = new MediaDrm(WISEPLAY_DRM_UUID);
  5.    byte[] sessionId = mediaDrm.openSession();
  6.    String PSSH_BOX = "AAAAY3Bzc2gBAAAAPV5tNZuaQei4Q908bnLELAAAAAPNI3qKPeyxmFVnqmWqx5pmxpmL7+8Am67T7xI7qk7vVncfJnvmvqyBLvozK5iuE84AAAAPcXZhc2pGU2ZkZ2Zqc1ZD";
  7.    byte[] initData = Base64.decode(PSSH_BOX, Base64.DEFAULT);
  8.    String mimeType = "video/mp4";
  9.    //... The initData needs to parse the information from the movie.
  10.    MediaDrm.KeyRequest keyRequest = mediaDrm.getKeyRequest(sessionId, initData, mimeType, MediaDrm.KEY_TYPE_STREAMING, null);
  11.    // Start the license request.
  12.    // Set content-type to application/json
  13.    byte [] data = keyRequest.getData();
  14.    // Use license url and data to request the license.
  15.    URL url = new URL(licenseServerUrl);
  16.    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
  17.    connection.setRequestMethod("POST");
  18.    connection.setDoOutput(true);
  19.    connection.setDoInput(true);
  20.    connection.setRequestProperty("content-type", "application/json");
  21.    connection.connect();
  22.    String body = "{\"payload\":\""+new String(data , UTF_8)+"\",\"psshBox\":\""+initData+"\",\"keyType\":\""+MediaDrm.KEY_TYPE_STREAMING+"\"}";
  23.    BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(connection.getOutputStream(), "UTF-8"));
  24.    writer.write(body);
  25.    writer.close();
  26.    int responseCode = connection.getResponseCode();
  27.    if (responseCode == HttpURLConnection.HTTP_OK) {
  28.        InputStream inputStream = connection.getInputStream();
  29.        byte[] response = toByteArray(inputStream);
  30.        inputStream.close();
  31.        connection.disconnect();
  32.        mediaDrm.provideKeyResponse(sessionId, response);
  33.    }
  34. } catch (UnsupportedSchemeException | ResourceBusyException | NotProvisionedException | IOException | DeniedByServerException e) {
  35.    e.printStackTrace();
  36. }

内容解密

  1. 创建MediaCrypto对象,传入WisePlay DRM的UUID以及前边获取到的sessionId;

  2. 创建MediaCodec对象,调用configure方法配置MediaCodec,传入之前创建的MediaCrypto对象;

  3. 解析媒体数据,根据解析到的数据创建CryptoInfo对象(此信息封装了ISO/IEC (FDIS 23001-7:2016)“ISO基本媒体文件格式文件中的普通加密”中概述的元数据。);

  4. 调用MediaCodec的dequeueInputBuffer,从 input 缓冲区队列申请空buffer;

  5. 把需要解码的每一帧数据拷贝到前边申请的空buffer,然后调用MediaCodec的queueSecureInputBuffer,将要解码的数据放入 input 缓冲区队列解码;

  6. MediaCodec 模块从 input 缓冲区队列取一帧数据进行解码处理,解码处理结束后,MediaCodec 将原始数据 buffer 置为 empty 后放回 input 缓冲区队列,将解码后的数据放入到 output 缓冲区队列;

  7. 调用MediaCodec的dequeueOutputBuffer,从 output 缓冲区队列获取解码后的数据buffer;

  8. 调用MediaCodec的releaseOutputBuffer,对编解码后的 buffer 进行渲染/播放,渲染/播放完成后,再将该 buffer 释放回 output 缓冲区队列。

离线license管理

1.获取离线license信息

  1. 对于离线License,在获取到License之后,调用provideKeyResponse方法,底层会返回这个离线License对应的keySetId,即离线licence的唯一id,业务需要自己保存这个id;

  2. 调用MediaDrm的restoreKeys,传入keySetId,后续即可使用该离线License。如果license已过期或keySetid不存在,则restoreKeys会失败,客户端需要重新到服务端申请License;

  3. 使用MediaDrm的queryKeyStatus方法可查询license的剩余可播放时长和剩余有效期时长。

    代码样例:

  1. UUID WISEPLAY_DRM_UUID = new UUID(0x3d5e6d359b9a41e8L, 0xb843dd3c6e72c42cL);  
  2. MediaDrm mediaDrm = null;
  3. try {
  4.    mediaDrm = new MediaDrm(WISEPLAY_DRM_UUID);
  5.    byte[] sessionId = mediaDrm.openSession();
  6.    // The keySetId of the offline license has been downloaded.
  7.    boolean restoerKeys = restoreKeys(sessionId, keySetId);
  8.    if (restoerKeys){
  9.        HashMap<String, String>licenseStatus = mediaDrm.queryKeyStatus(keySetId);
  10.        // Remaining duration for playing a license.
  11.        long playbackDuration = Long.parseLong(licenseStatus.get("PlaybackDurationRemaining"));
  12.        // Remaining license duration
  13.        long licenseDuration = Long.parseLong(licenseStatus.get("LicenseDurationRemaining"));
  14.    } else{
  15.        // Delete the cache of the license association relationship.
  16.    }
  17. } catch (UnsupportedSchemeException e) {
  18.    e.printStackTrace();
  19. } catch (ResourceBusyException e) {
  20.    e.printStackTrace();
  21. } catch (NotProvisionedException e) {
  22.    e.printStackTrace();
  23. }

  24. public boolean restoreKeys(byte[] sessionId, byte[] keySetId) {
  25.    try {
  26.        mediaDrm.restoreKeys(sessionId, keySetId);
  27.        return true;
  28.    } catch (Exception e){
  29.        return false;
  30.    }
  31. }

2. 删除离线license

  1. 和获取license的流程一致,区分在于调用MeidaDrm的getKeyRequest接口的传参。

    代码样例:

  1. UUID WISEPLAY_DRM_UUID = new UUID(0x3d5e6d359b9a41e8L, 0xb843dd3c6e72c42cL);
  2. MediaDrm mediaDrm = null;
  3. try {
  4.    mediaDrm = new MediaDrm(WISEPLAY_DRM_UUID);
  5.    byte[] sessionId = mediaDrm.openSession();
  6.    //... The initData needs to parse the information from the movie.
  7.    MediaDrm.KeyRequest keyRequest = mediaDrm.getKeyRequest(keySetId, null, null, MediaDrm.KEY_TYPE_RELEASE, null);
  8.    // Start the license request.
  9.    //  Set content-type to application/json
  10.    byte [] data = keyRequest.getData();
  11.    // Use license url and data to request the license.
  12.    URL url = new URL(licenseServerUrl);
  13.    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
  14.    connection.setRequestMethod("POST");
  15.    connection.setDoOutput(true);
  16.    connection.setDoInput(true);
  17.    connection.setRequestProperty("content-type", "application/json");
  18.    connection.connect();
  19.    String body = "{\"payload\":\""+new String(data , UTF_8)+"\",\"psshBox\":\""+initData+"\",\"keyType\":\""+MediaDrm.KEY_TYPE_RELEASE+"\"}";
  20.    BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(connection.getOutputStream(), "UTF-8"));
  21.    writer.write(body);
  22.    writer.close();
  23.    int responseCode = connection.getResponseCode();
  24.    if (responseCode == HttpURLConnection.HTTP_OK) {
  25.        InputStream inputStream = connection.getInputStream();
  26.        byte[] response = toByteArray(inputStream);
  27.        inputStream.close();
  28.        connection.disconnect();
  29.        mediaDrm.provideKeyResponse(sessionID, response);
  30.    }
  31. } catch (UnsupportedSchemeException e) {
  32.    e.printStackTrace();
  33. } catch (ResourceBusyException e) {
  34.    e.printStackTrace();
  35. } catch (NotProvisionedException e) {
  36.    e.printStackTrace();
  37. }

3. 使用离线license播放

  1. 通过MediaDrm的restoreKeys方法传入sessionId和license的keySetId判断license是否可以恢复,可以的话进行下一步;否则删除本地缓存的license关联关系;

  2. 如果license已经过期不要初始化编解码器。

4.播放过程中监听license

  1. 通过MeidaDrm的setOnEventListener方法设置listener监听;

  2. 如果listener的event等于MediaDrm.EVENT_KEY_REQUIRED,表示license即将过期(license有效期还有30秒的时候触发);

  3. 如果listener的event等于MediaDrm.EVENT_KEY_EXPIRED,表示license已经过期;

  4. 如果即将过期,业务可自行决定是否触发重新申请license流程。