本示例介绍如何使用Alibaba Cloud SDK for Java调用UpdateLiveAppSnapshotConfig接口更新截图配置。

更新直播流下的 AppName 截图配置,输出内容保存到 OSS 中,重新推流生效。

前提条件

请在pom.xml文件中增加以下依赖,准确的SDK版本号,参见 阿里云开发工具包(JavaSDK)

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-live</artifactId>
    <version>3.7.5</version>
 </dependency>

示例代码

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.live.model.v20161101.UpdateLiveAppSnapshotConfigRequest;
import com.aliyuncs.live.model.v20161101.UpdateLiveAppSnapshotConfigResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import com.ygx.testprogram.ECSConfig;

public class TestUpdateLiveAppSnapshotConfig {
    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile(
                "<your-region-id>", // 地域ID
                "<your-access-key-id>", // 您的AccessKey ID
                "<your-access-key-secret>"); // 您的AccessKey Secret
        IAcsClient client = new DefaultAcsClient(profile);

        UpdateLiveAppSnapshotConfigRequest request = new UpdateLiveAppSnapshotConfigRequest();
        /**
         * OSS 存储文件名。每次截图都递增存储, DescribeLiveStreamSnapshotInfo 接口查询一段时间的文件。
         * 小于 256bytes。
         * 目前仅支持生成 jpg 图片。
         * 支持变量匹配,包含
         * {AppName}、{StreamName}、{UnixTimestamp}、{Sequence},其中 {UnixTimestamp}、{Sequence} 必填一个,
         * 如:snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg。
         */
        request.setSequenceOssObject("snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg");
        /**
         * OSS 存储文件名,每次截图都覆盖此文件。
         * 小于 256bytes。
         * 目前仅支持生成 jpg 图片。
         * 支持变量匹配,包含 {AppName}、{StreamName},如:{AppName}/{StreamName}.jpg。
         */
        request.setOverwriteOssObject("{AppName}/{StreamName}.jpg");
        // 截图周期。取值范围:[5,3600] 单位:秒。
        request.setTimeInterval(5);
        // OSSEndpoint域名。
        request.setOssEndpoint("oss-cn-shanghai.aliyuncs.com");
        // OSSBucket名称。
        request.setOssBucket("test123");
        // 您的加速域名。
request.setDomainName("live.aliyuntest.club");
        // 直播流所属应用名称。支持通配符*号,代表该域名下所有的 AppName。
        request.setAppName("testApp");

        try {
            UpdateLiveAppSnapshotConfigResponse response = client.getAcsResponse(request);
            // 处理业务逻辑。
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }

}
说明 更多参数信息,请参见API参考