ApsaraVideo Live:Use the server SDK for Java

Install the SDK

To install the server SDK for Java by using Maven, add the following dependencies to the pom.xml file in your project:

<!-- Alibaba Cloud Core SDK -->
<dependency>    
    <groupId>com.aliyun</groupId>    
    <artifactId>aliyun-java-sdk-core</artifactId>    
    <version>4.6.1</version>
</dependency>
<!-- ApsaraVideo Live SDK -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-live</artifactId>
    <version>3.9.59</version>
</dependency>

Use the SDK

The server SDK for Java supports various features. The following sample code provides an example on how to query the snapshot configurations of a streaming domain:

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();
        }

    }

}

In this example, DescribeLiveSnapshotConfigResponse is a deserialized response object. If you want to work directly with the raw HTTP response, change the client.getAcsResponse method to the client.doAction method. Sample code:

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

Note:

• HTTP status codes from 200 to 299 indicate successful calls.

• HTTP status codes from 300 to 499 trigger the SDK to throw a ClientException, which indicates a client error.

• HTTP status codes 500 and above trigger the SDK to throw a ServerException, which indicates a server error.

We recommend that you save the AccessKey pair in a properties file so that the SDK can get the AccessKey pair when needed. The following sample code shows how to configure it in a Spring Boot-based project:

# The AccessKey ID and AccessKey secret requested by the server SDK.
live.accessKeyId=<yourAccessKeyId>
live.accessKeySecret=<yourAccessKeySecret>

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

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

The following table lists some common APIs of ApsaraVideo Live.

Access control

In addition to system policies that authorize RAM users to access APIs, you can create custom policies to implement finer-grained access control based on the resource type. For example, you can configure a policy to grant RAM User A access to an API operation only on Domain A and RAM User B access only on Domain B. For information about how to implement access control, see Create a custom policy.

The API reference provides the authorization information of each API, describing what permissions you can grant to a RAM user or role for using the operation. The following figure shows the authorization information of the AddLiveAppSnapshotConfig operation.