本文為您介紹Android端接入K歌房的操作指引。

源碼說明

源碼地址

源碼地址請參見Android源碼。

源碼結構

需要用到3個組件庫，AUIBaseKits、AUIVoiceRoomEngine和AUIKaraokeRoomEngine，結構如下：

├── Android       //Android平臺工程結構跟目錄
│   ├── AUIBaseKits    //AUI基礎組件
│   ├── AUIKaraokeRoomEngine //場景接口與實現
│   ├── AUIVoiceRoomEngine // 語聊場景接口與實現
│   ├── README.md
│   ├── app           //Demo
│   ├── build.gradle  
│   └── settings.gradle

環境要求

• Android Studio插件版本4.1.3

• Gradle 7.0.2

• Android Studio自帶JDK 11

前提條件

需要開通應用，并且在你的服務端上開發相關接口或直接部署提供的Server源碼，請參見前置準備。

快速集成

在已有的工程上接入K歌房場景化能力，只需要AUIKaraokeRoomEngine模塊。

工程配置

1. 導入AUIKaraokeRoomEngine。

倉庫代碼下載后，Android Studio菜單選擇：File > New > Import Module，導入選擇文件夾。

2. 修改文件夾下的build.gradle的第三方庫依賴項。

dependencies {

    implementation 'androidx.appcompat:appcompat:x.x.x'                     //修改x.x.x為你工程適配的版本
    implementation 'com.google.android.material:material:x.x.x'             //修改x.x.x為你工程適配的版本
    androidTestImplementation 'androidx.test.espresso:espresso-core:x.x.x'  //修改x.x.x為你工程適配的版本
    implementation 'com.aliyun.aio:AliVCSDK_Standard:x.x.x'                  //修改x.x.x為你工程適配的版本
}

3. 等待gradle同步完成，完成源碼集成。

源碼配置

1. 完成前提條件后，進入文件KTVServerConstant.java，修改服務端域名。

//  KTVServerConstant.java
public static final String HOST = "你的應用服務器域名";

2. 完成前提條件后，進入文件KTVServerConstant.java，修改實時音視頻應用ID。

//  KTVServerConstant.java
public static final String APP_ID = "你的實時音視頻應用appID";

調用API示例

上述步驟完成后，您可以根據自身的業務場景和交互，在您App的其他模塊或主頁上通過組件接口快速實現K歌房功能，也可以根據自身的需求修改源碼，具體可以參考AUIKaraokeRoom模塊中ARTCKaraokeRoomEngine接口被調用處的代碼。