本文介紹視頻直播服務端Java SDK的使用方法和示例代碼。
前提條件
創建RAM用戶并授權。訪問視頻直播API需要RAM用戶擁有對應的權限,具體授權操作可參見創建RAM用戶并授權。
已獲取訪問密鑰(AccessKey)。服務端接口通過訪問密鑰進行身份驗證,為RAM用戶生成訪問密鑰請參見創建AccessKey。
已完成Java 環境配置,需要Java 1.6及以上版本。
使用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();
}
}
}
您可以使用該示例代碼進行測試,測試時需將“<>”內容替換成實際使用的值。
<regionId>為地域ID,地域ID獲取可參見服務接入點。
<ALIBABA_CLOUD_ACCESS_KEY_ID>與<ALIBABA_CLOUD_ACCESS_KEY_SECRET>為訪問密鑰,如果您還未擁有訪問密鑰,請參見本文檔前提條件相關內容。
DescribeLiveSnapshotConfigRequest為查詢截圖配置對應請求類。
DescribeLiveSnapshotConfigResponse為查詢截圖配置對應響應類。
請求參數以及響應內容說明可參見APIDescribeLiveSnapshotConfig - 查詢域名下的截圖配置。
調用API有QPS限制,關于API的QPS限制說明請參見流控信息。
在以上示例中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;
在使用視頻直播SDK時遵循API
加Request
為API請求類,API
加Response
為API響應類。
此處列舉幾個常用API。
API | 請求類 | 響應類 |
DescribeLiveSnapshotConfig | DescribeLiveSnapshotConfig | |
AddLiveAppRecordConfig | AddLiveAppRecordConfig | |
DescribeLiveRecordConfig | DescribeLiveRecordConfig | |
AddLiveStreamTranscode | AddLiveStreamTranscode | |
DescribeLiveStreamTranscodeInfo | DescribeLiveStreamTranscodeInfo | |
BatchSetLiveDomainConfigs | BatchSetLiveDomainConfigs | |
DescribeLiveDomainConfigs | DescribeLiveDomainConfigs | |
更多API可參見API概覽。 |
資源控制
在您查看API的過程中,可能已留意到API有關授權信息的說明,比如在AddLiveAppSnapshotConfig - 添加直播截圖配置API中,有以下關于授權信息的內容。
在為RAM用戶授權的過程中,您已為RAM用戶授予了API的訪問權限。但有些時候您可能需要更細的權限控制,比如調用同一個API,RAM用戶A只能操作DomainA域名,RAM用戶B只能操作DomainB域名。如果您有這樣的業務需求就可以通過資源控制進行實現,實現資源控制授權可參考文檔自定義授權。
各API支持的資源控制說明請參見API授權信息總覽。