Java騰訊雲音視頻對接

本文旨在從多個方面詳細闡述Java騰訊雲音視頻對接，提供完整的代碼示例。

一、騰訊雲音視頻介紹

騰訊雲音視頻服務（Cloud Tencent Real-Time Communication）是一款覆蓋全球的實時音視頻通信服務，擁有高品質的音視頻通話、直播、雲錄製、點播等音視頻功能。可廣泛應用於教育、醫療、在線娛樂等領域。

二、引入騰訊雲SDK

要使用騰訊雲音視頻服務，首先需要在項目中引入騰訊雲SDK。

<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java</artifactId>
    <version>3.0.132</version>
</dependency>

三、音視頻通話

音視頻通話是騰訊雲音視頻服務中最常用的功能之一。

1. 創建 TRTC 實例

在開始之前，需要從騰訊雲控制台獲取 SDKAppID 和 SecretKey，然後使用此信息創建 TRTC 實例。

import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.trtc.v20190722.TrtcClient;
import com.tencentcloudapi.trtc.v20190722.models.*;

public static TrtcClient createClient(String secretId, String secretKey) {
    Credential cred = new Credential(secretId, secretKey);
    ClientProfile clientProfile = new ClientProfile();
    return new TrtcClient(cred, "", clientProfile);
}

String secretId = "your-secret-id";
String secretKey = "your-secret-key";
TrtcClient client = createClient(secretId, secretKey);

2. 創建房間

創建房間是音視頻通話的第一步，需要指定房間號和用戶ID。

public static CreateRoomResponse createRoom(TrtcClient client, String sdkAppId, Integer roomNumber, String userId) throws Exception {
    CreateRoomRequest req = new CreateRoomRequest();
    req.setSdkAppId(sdkAppId);
    req.setRoomId(roomNumber.toString());
    req.setUserId(userId);
    return client.CreateRoom(req);
}

String sdkAppId = "your-sdk-app-id";
int roomNumber = 1234;
String userId = "your-user-id";
CreateRoomResponse res = createRoom(client, sdkAppId, roomNumber, userId);

3. 加入房間

加入房間是音視頻通話的第二步，需要指定房間號和用戶ID。

public static JoinRoomResponse joinRoom(TrtcClient client, String sdkAppId, Integer roomNumber, String userId) throws Exception {
    JoinRoomRequest req = new JoinRoomRequest();
    req.setSdkAppId(sdkAppId);
    req.setRoomId(roomNumber.toString());
    req.setUserId(userId);
    return client.JoinRoom(req);
}

JoinRoomResponse res = joinRoom(client, sdkAppId, roomNumber, userId);

4. 推流/拉流

通過推流和拉流可以實現音視頻的傳輸。

public static void publishStream(TrtcClient client, String streamId, String signature) throws Exception {
    PublishStreamRequest req = new PublishStreamRequest();
    req.setSignature(signature);
    req.setStreamId(streamId);
    req.setStartTime(System.currentTimeMillis() / 1000);
    client.PublishStream(req);
}

public static void playStream(TrtcClient client, String streamId, String signature) throws Exception {
    PlayStreamRequest req = new PlayStreamRequest();
    req.setSignature(signature);
    req.setStreamId(streamId);
    req.setStartTime(System.currentTimeMillis() / 1000);
    client.PlayStream(req);
}

String streamId = "1234";
String signature = "your-signature";
publishStream(client, streamId, signature);
playStream(client, streamId, signature);

四、跨房間連麥

跨房間連麥是騰訊雲音視頻服務中的高級功能之一，可以實現多個房間之間的音視頻連麥。

1. 創建連接

在創建連接之前，需要先創建兩個房間。

int roomNumber1 = 1234;
String userId1 = "user1";
int roomNumber2 = 5678;
String userId2 = "user2";
createRoom(client, sdkAppId, roomNumber1, userId1);
createRoom(client, sdkAppId, roomNumber2, userId2);

然後分別在兩個房間中加入房間。

joinRoom(client, sdkAppId, roomNumber1, userId1);
joinRoom(client, sdkAppId, roomNumber2, userId2);

最後創建連接，指定兩個房間的房間號和用戶ID。

public static CreateLinkResponse createLink(TrtcClient client, String sdkAppId, int roomId1, String userId1, int roomId2, String userId2) throws Exception {
    CreateLinkRequest req = new CreateLinkRequest();
    req.setSdkAppId(sdkAppId);
    req.setFromRoomId(roomId1);
    req.setFromUserId(userId1);
    req.setToRoomId(roomId2);
    req.setToUserId(userId2);
    return client.CreateLink(req);
}

CreateLinkResponse res = createLink(client, sdkAppId, roomNumber1, userId1, roomNumber2, userId2);

2. 斷開連接

斷開連接就是直接刪除先前創建的連接。

public static DeleteLinkResponse deleteLink(TrtcClient client, String sdkAppId, String linkId) throws Exception {
    DeleteLinkRequest req = new DeleteLinkRequest();
    req.setSdkAppId(sdkAppId);
    req.setLinkId(linkId);
    return client.DeleteLink(req);
}

String linkId = res.getLinkId();
deleteLink(client, sdkAppId, linkId);

五、直播功能

騰訊雲音視頻服務不僅可以實現音視頻通話，還可以實現直播功能。

1. 創建直播

創建直播需要指定直播名稱和推流地址。

public static CreateLiveResponse createLive(TrtcClient client, String streamName, String pushUrl) throws Exception {
    CreateLiveRequest req = new CreateLiveRequest();
    req.setStreamName(streamName);
    req.setPushUrl(pushUrl);
    return client.CreateLive(req);
}

String streamName = "live-stream";
String pushUrl = "your-push-url";
CreateLiveResponse res = createLive(client, streamName, pushUrl);

2. 開始直播/停止直播

開始直播和停止直播是直播功能的核心操作。

public static void startLive(TrtcClient client, String streamId) throws Exception {
    StartLiveRequest req = new StartLiveRequest();
    req.setStreamId(streamId);
    req.setStartTime(System.currentTimeMillis() / 1000);
    client.StartLive(req);
}

public static void stopLive(TrtcClient client, String streamId) throws Exception {
    StopLiveRequest req = new StopLiveRequest();
    req.setStreamId(streamId);
    req.setEndTime(System.currentTimeMillis() / 1000);
    client.StopLive(req);
}

String streamId = res.getStreamId();
startLive(client, streamId);
stopLive(client, streamId);

六、總結

本文詳細闡述了Java騰訊雲音視頻對接的多個方面，並且提供了完整的代碼示例，可供開發者參考和學習。