最近更新时间:2024.04.15 11:36:59
首次发布时间:2023.12.28 21:21:52
阅读本文,您可以获取 Java SDK 直播时移的接口调用示例,实现快速开发。
说明
本文的调用示例包含接口的全部参数。由于参数间可能存在互斥关系,在调用时,请您参考注释,进行调整。
调用接口前,请先完成 Java SDK 的安装及初始化操作
本节为您介绍直播时移相关接口的功能和调用示例。
您可以调用 CreateTimeShiftPresetV3 接口添加直播时移配置。详细的参数说明可参见 CreateTimeShiftPresetV3 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.CreateTimeShiftPresetV3Body; import com.volcengine.model.live.v20230101.CreateTimeShiftPresetV3Res; import com.volcengine.service.live.v20230101.LiveService; public class CreateTimeShiftPresetV3Demo { 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")); CreateTimeShiftPresetV3Body body = new CreateTimeShiftPresetV3Body(); // 域名空间,即直播流地址的域名所属的域名空间。您可以调用 [ListDomainDetail](https//www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https//console-stable.volcanicengine.com/live/main/domain/list)页面,查看需要时移的直播流使用的域名所属的域名空间。 body.setVhost("push.example.com"); // 应用名称,取值与直播流地址中 AppName 字段取值相同。支持由大小写字母(A - Z、a - z)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 30 个字符。 body.setApp("live"); // 流名称,取值与直播流地址中 StreamName 字段取值相同,默认为空表示当前应用下的所有流都进行时移。支持由大小写字母(A - Z、a - z)、下划线(_)、短横线(-)和句点(.)组成,长度为 1 到 100 个字符。 // note: // 流名称不为空时,表示只为此条流开启时移。通过流名称配置时移时,同一个 App 最多可指定 20 路流开启时移。 body.setStream("example_stream"); // 最大时移时长,即允许用户回看的最长时间,单位为秒,支持的取值如下所示。 // <li> `86400`:1 天; </li> // <li> `259200`:3 天; </li> // <li> `604800`:7 天; </li> // <li> `1296000`:15 天。 </li> body.setMaxShiftTime(86400); // 时移拉流域名。 // note: // 录制到 TOS 时,需配置直播流对应的拉流域名。录制到 VOD 时,需配置 VOD 的空间对应的分发域名。 body.setPullDomain("testpull"); // 时移类型。支持的取值如下所示。 // <li> `0`:录制时移,即时移复用录制配置,需提前创建对应级别的录制配置; </li> // <li> `1`:独立时移,即时移不复用录制配置。 </li> body.setTimeShiftType(0); try { CreateTimeShiftPresetV3Res resp = service.createTimeShiftPresetV3(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 DeleteTimeShiftPresetV3 接口删除直播时移配置。详细的参数说明可参见 DeleteTimeShiftPresetV3 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.DeleteTimeShiftPresetV3Body; import com.volcengine.model.live.v20230101.DeleteTimeShiftPresetV3Res; import com.volcengine.service.live.v20230101.LiveService; public class DeleteTimeShiftPresetV3Demo { 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")); DeleteTimeShiftPresetV3Body body = new DeleteTimeShiftPresetV3Body(); // 域名空间名称,您可以调用[ListTimeShiftPresetV2](https//www.volcengine.com/docs/6469/1126883) 接口,获取待删除时移配置的 `Vhost` 取值。 body.setVhost("push.example.com"); // 应用名称,您可以调用[ListTimeShiftPresetV2](https//www.volcengine.com/docs/6469/1126883) 接口,获取待删除时移配置的 `App` 取值。 body.setApp("live"); try { DeleteTimeShiftPresetV3Res resp = service.deleteTimeShiftPresetV3(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 UpdateTimeShiftPresetV3 接口更新直播时移配置。详细的参数说明可参见 UpdateTimeShiftPresetV3 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.UpdateTimeShiftPresetV3Body; import com.volcengine.model.live.v20230101.UpdateTimeShiftPresetV3Res; import com.volcengine.service.live.v20230101.LiveService; public class UpdateTimeShiftPresetV3Demo { 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")); UpdateTimeShiftPresetV3Body body = new UpdateTimeShiftPresetV3Body(); // 域名空间名称,您可以调用[ListTimeShiftPresetV2](https//www.volcengine.com/docs/6469/1126883) 接口,获取待更新时移配置的 `Vhost` 取值。 body.setVhost("push.example.com"); // 应用名称,您可以调用[ListTimeShiftPresetV2](https//www.volcengine.com/docs/6469/1126883) 接口,获取待更新时移配置的 `App` 取值。 body.setApp("live"); // 开启时移的流名称,默认为空表示更新 App 级别的时移配置,不为空时表示更新 Stream 级别的时移配置。您可以调用[ListTimeShiftPresetV2](https//www.volcengine.com/docs/6469/1126883) 接口,获取待更新时移配置的 `Stream` 取值并进行更新。 body.setStream("example_stream"); // 最大时移时长,即允许用户回看的最长时间,单位为秒,支持的取值如下所示。 // <li> `86400`:1 天; </li> // <li> `259200`:3 天; </li> // <li> `604800`:7 天; </li> // <li> `1296000`:15 天。 </li> body.setMaxShiftTime(86400); try { UpdateTimeShiftPresetV3Res resp = service.updateTimeShiftPresetV3(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }
您可以调用 ListTimeShiftPresetV2 接口查询直播时移配置列表。详细的参数说明可参见 ListTimeShiftPresetV2 接口文档。
接口调用示例如下所示。
package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.ListTimeShiftPresetV2Body; import com.volcengine.model.live.v20230101.ListTimeShiftPresetV2Res; import com.volcengine.service.live.v20230101.LiveService; public class ListTimeShiftPresetV2Demo { 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")); ListTimeShiftPresetV2Body body = new ListTimeShiftPresetV2Body(); // 时移类型,默认类型为 `vod`。 // <li> `vod`:点播时移,表示查询时移录制存储在 VOD 中的时移配置; </li> // <li> `tos`:直播时移,表示查询时移录制存储在 TOS 以及 fcdn-tos 中的时移配置。 </li> body.setType("tos"); // 域名空间,即直播流地址的域名所属的域名空间。您可以调用 [ListDomainDetail](https//www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https//console-stable.volcanicengine.com/live/main/domain/list)页面,查看需要时移的直播流使用的域名所属的域名空间。 body.setVhost("push.example.com"); try { ListTimeShiftPresetV2Res resp = service.listTimeShiftPresetV2(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } }