阅读本文,您可以获取 Java SDK DRM管理的接口调用示例,实现快速开发。
说明
本文的调用示例包含接口的部分参数。由于参数间可能存在互斥关系,在调用时,请您参考注释,进行调整。
调用接口前,请先完成 Java SDK 的安装及初始化操作。
本节为您介绍DRM管理相关接口的功能和调用示例。
您可以调用 UpdateEncryptDRM 接口更新 DRM 证书管理平台访问密钥和 FairPlay 证书。详细的参数说明可参见 UpdateEncryptDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class UpdateEncryptDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); UpdateEncryptDRMBody body = new UpdateEncryptDRMBody(); // DRM 证书管理平台 API 访问密钥,获取方法请参见[最佳实践-直播 DRM 加密](https://www.volcengine.com/docs/6469/1219836#在-intertrust-平台创建访问密钥)。 body.setAPIKey("12312,162632123abfc344321234212344323432"); // 自定义 FairPlay 证书名称,支持由小写字母(a - z)、数字(0 - 9)和短横线(-)组成,最小长度为 2个字符,最大长度为 128 个字符。FairPlay 证书相关参数的获取方法请参见[最佳实践-直播 DRM 加密](https://www.volcengine.com/docs/6469/1219836#在-apple-官网获取-fairplay-证书)。 body.setCertificateName("test-drm-cert"); // 申请 FairPlay 证书时创建的私钥文件内容。 body.setPrivateKeyFile("asdasdasdasd1w1wd1wd"); // 申请 FairPlay 证书时创建的私钥文件名称。 body.setPrivateKeyFileName("pri.pem"); // FairPlay 证书文件内容。 body.setCertificateFile("asd13dsfdasdasd1ewd"); // FairPlay 证书文件名称。 body.setCertificateFileName("certificate.cer"); // 申请 FairPlay 证书过程中 Apple 返回的 ASk(Application Secret Key)字符串。 body.setApplicationSecretKey("NODIW347219BIUDW93"); // 申请 FairPlay 证书时创建的私钥文件密钥。 body.setPrivateKey("2023"); try { UpdateEncryptDRMRes resp = service.updateEncryptDRM(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 DescribeEncryptDRM 接口查看 DRM 证书管理平台访问密钥和 FairPlay 证书。详细的参数说明可参见 DescribeEncryptDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeEncryptDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); try { DescribeEncryptDRMRes resp = service.describeEncryptDRM(); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 BindEncryptDRM 接口添加或更新 DRM 加密配置。详细的参数说明可参见 BindEncryptDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class BindEncryptDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); BindEncryptDRMBody body = new BindEncryptDRMBody(); // 域名空间,即直播流地址的域名所属的域名空间。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面,查看直播流使用的域名所属的域名空间。 body.setVhost("push.example.com"); // 应用名称,取值与直播流地址中 `AppName` 字段取值相同。支持由大小写字母(A - Z、a - z)、数字(0 - 9)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 30 个字符。 body.setApp("live"); // 是否开启当前 DRM 加密配置,取值及含义如下所示。 // <li> `true`:开启; </li> // <li> `false`:关闭。 </li> body.setEnable(true); // 待加密的转码流对应的转码流后缀配置。您可以调用[查询转码配置列表](https://www.volcengine.com/docs/6469/1126853)接口或在视频直播控制台的[转码配置](https://console.volcengine.com/live/main/application/transcode)页面,查看转码配置的转码流后缀。 List<String> EncryptTranscodeSuffix = new ArrayList<>(); EncryptTranscodeSuffix.add("hd"); body.setEncryptTranscodeSuffix(EncryptTranscodeSuffix); try { BindEncryptDRMRes resp = service.bindEncryptDRM(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 ListBindEncryptDRM 接口查询 DRM 加密配置。详细的参数说明可参见 ListBindEncryptDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class ListBindEncryptDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); ListBindEncryptDRMBody body = new ListBindEncryptDRMBody(); // 域名空间,即直播流地址的域名所属的域名空间。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面,查看直播流使用的域名所属的域名空间。 body.setVhost("push.example.com"); // 应用名称,取值与直播流地址中 `AppName` 字段取值相同,默认为空,表示查询符合域名空间取值的所有的 DRM 加密配置。支持由大小写字母(A - Z、a - z)、数字(0 - 9)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 30 个字符。 body.setApp("live"); try { ListBindEncryptDRMRes resp = service.listBindEncryptDRM(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 UnBindEncryptDRM 接口删除 DRM 加密配置。详细的参数说明可参见 UnBindEncryptDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class UnBindEncryptDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); UnBindEncryptDRMBody body = new UnBindEncryptDRMBody(); // 域名空间,即直播流地址的域名所属的域名空间。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面,查看直播流使用的域名所属的域名空间。 body.setVhost("push.example.com"); // 应用名称,取值与直播流地址中 `AppName` 字段取值相同。支持由大小写字母(A - Z、a - z)、数字(0 - 9)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 30 个字符。 body.setApp("live"); try { UnBindEncryptDRMRes resp = service.unBindEncryptDRM(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 DescribeLicenseDRM 接口获取 DRM 授权许可文件。详细的参数说明可参见 DescribeLicenseDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLicenseDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); DescribeLicenseDRMQuery query = new DescribeLicenseDRMQuery(); // 应用名称,取值与直播流地址的 AppName 字段相同,由大写小字母(A - Z、a - z)、数字(0 - 9)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 30 个字符。 query.setApp("live"); // DRM 加密的类型,取值及含义如下所示。 // <li> `fp`:FairPlay 加密; </li> // <li> `wv`:Widevine 加密。 </li> query.setDRMType("fp"); // 拉流域名,您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面,查看直播流使用的拉流域名。 query.setDomain("pull.example.com"); // 流名称,取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母(A - Z、a - z)、数字(0 - 9)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 100 个字符。 query.setStreamName("stream-drm"); // 拉取加密流时使用的拉流域名所在的域名空间。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面,查看直播流使用的拉流域名所属的域名空间。 query.setVhost("drm.example.com"); try { DescribeLicenseDRMRes resp = service.describeLicenseDRM(query); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 DescribeCertDRM 接口获取 FairPlay 证书文件。详细的参数说明可参见 DescribeCertDRM 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeCertDRMDemo { public static void main(String[] args) { // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里,否则可能导致 AccessKey 泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret,来实现 API 访问的身份验证。运行代码示例前,请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("ACCESS_KEY_ID")); service.setSecretKey(System.getenv("ACCESS_KEY_SECRET")); DescribeCertDRMQuery query = new DescribeCertDRMQuery(); // 域名空间,即直播流地址的域名(`Domain`)所属的域名空间(`Vhost`)。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面,查看直播流使用的域名所属的域名空间。 query.setVhost("drm.example.com"); // 应用名称,取值与直播流地址中 AppName 字段取值相同。支持由大小写字母(A - Z、a - z)、数字(0 - 9)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 30 个字符。 query.setApp("live"); try { DescribeCertDRMRes resp = service.describeCertDRM(query); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }