Java SDK使用说明

安装

此处以Maven安装方式进行举例，在项目pom.xml文件中引入SDK：

<!-- 阿里云核心SDK -->
<dependency>    
    <groupId>com.aliyun</groupId>    
    <artifactId>aliyun-java-sdk-core</artifactId>    
    <version>4.6.1</version>
</dependency>
<!-- 视频直播SDK -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-live</artifactId>
    <version>3.9.59</version>
</dependency>

使用

以下示例代码实现了使用SDK查询直播截图配置的功能。

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.live.model.v20161101.DescribeLiveSnapshotConfigRequest;
import com.aliyuncs.live.model.v20161101.DescribeLiveSnapshotConfigResponse;
import com.aliyuncs.profile.DefaultProfile;

public class SdkUseDemo {
    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");        
        IAcsClient client = new DefaultAcsClient(profile);
        DescribeLiveSnapshotConfigRequest describeLiveStreamSnapshotInfoRequest=new DescribeLiveSnapshotConfigRequest();
        describeLiveStreamSnapshotInfoRequest.setDomainName("<DomainName>");
        DescribeLiveSnapshotConfigResponse describeLiveSnapshotConfigResponse = null;
        try {
            describeLiveSnapshotConfigResponse = client.getAcsResponse(describeLiveStreamSnapshotInfoRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }

    }

}

在以上示例中DescribeLiveSnapshotConfigResponse为反序列化后的响应对象，某些时候您可能需要直接获取响应结果HttpResponse，不需要进行反序列化，在此情况下只需更换调用方法即可。

HttpResponse httpResponse=client.doAction(describeLiveStreamSnapshotInfoRequest);
int status=httpResponse.getStatus();

使用说明：

• 当HTTP status大于等于200且小于300时，表示API调用成功。

• 当HTTP status大于等于300且小于500时，服务端SDK会提示ClientException，表示客户端错误。

• 当HTTP status大于等于500时，服务端SDK会提示ServerException，表示服务器端错误。

client.getAcsResponse与client.doAction两个方法都可以使用，您可以根据您业务的实际情况采用。

建议您将访问密钥保存至配置文件，在使用时进行读取。如果您的项目基于SpringBoot搭建，可参考以下示例代码：

# 客户端请求的ak、sk，就是应用的密钥信息
live.accessKeyId=<yourAccessKeyId>
live.accessKeySecret=<yourAccessKeySecret>

@Value("${live.accessKeyId}")
private String accessKeyId;

@Value("${live.accessKeySecret}")
private String accessKeySecret;

此处列举几个常用API。

资源控制

在您查看API的过程中，可能已留意到API有关授权信息的说明，比如在AddLiveAppSnapshotConfig - 添加直播截图配置API中，有以下关于授权信息的内容。

在为RAM用户授权的过程中，您已为RAM用户授予了API的访问权限。但有些时候您可能需要更细的权限控制，比如调用同一个API，RAM用户A只能操作DomainA域名，RAM用户B只能操作DomainB域名。如果您有这样的业务需求就可以通过资源控制进行实现，实现资源控制授权可参考文档自定义授权。