安裝

此處以Maven安裝方式進(jìn)行舉例，在項(xiàng)目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>

使用

以下示例代碼實(shí)現(xiàn)了使用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為反序列化后的響應(yīng)對(duì)象，某些時(shí)候您可能需要直接獲取響應(yīng)結(jié)果HttpResponse，不需要進(jìn)行反序列化，在此情況下只需更換調(diào)用方法即可。

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

使用說明：

• 當(dāng)HTTP status大于等于200且小于300時(shí)，表示API調(diào)用成功。

• 當(dāng)HTTP status大于等于300且小于500時(shí)，服務(wù)端SDK會(huì)提示ClientException，表示客戶端錯(cuò)誤。

• 當(dāng)HTTP status大于等于500時(shí)，服務(wù)端SDK會(huì)提示ServerException，表示服務(wù)器端錯(cuò)誤。

client.getAcsResponse與client.doAction兩個(gè)方法都可以使用，您可以根據(jù)您業(yè)務(wù)的實(shí)際情況采用。

建議您將訪問密鑰保存至配置文件，在使用時(shí)進(jìn)行讀取。如果您的項(xiàng)目基于SpringBoot搭建，可參考以下示例代碼：

# 客戶端請(qǐng)求的ak、sk，就是應(yīng)用的密鑰信息
live.accessKeyId=<yourAccessKeyId>
live.accessKeySecret=<yourAccessKeySecret>

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

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

此處列舉幾個(gè)常用API。

資源控制

在您查看API的過程中，可能已留意到API有關(guān)授權(quán)信息的說明，比如在AddLiveAppSnapshotConfig - 添加直播截圖配置API中，有以下關(guān)于授權(quán)信息的內(nèi)容。

在為RAM用戶授權(quán)的過程中，您已為RAM用戶授予了API的訪問權(quán)限。但有些時(shí)候您可能需要更細(xì)的權(quán)限控制，比如調(diào)用同一個(gè)API，RAM用戶A只能操作DomainA域名，RAM用戶B只能操作DomainB域名。如果您有這樣的業(yè)務(wù)需求就可以通過資源控制進(jìn)行實(shí)現(xiàn)，實(shí)現(xiàn)資源控制授權(quán)可參考文檔自定義授權(quán)。