Intelligent Media Services：整合概覽

步驟一：申請APP音視頻許可權

檢查APP麥克風、網路攝影機許可權，如未授權，則彈框交給使用者進行授權。業務App需要您自行實現, 參考代碼請參見PermissionUtils.java。

PermissionX.init(this)
.permissions(PermissionUtils.getPermissions())
.request((allGranted, grantedList, deniedList) -> {
});

步驟二：建立&初始化引擎

建立&初始化ARTCAICallEngine引擎，範例程式碼如下：

String userId = "123";  // userId推薦使用你的App登入後的使用者id
ARTCAICallEngineImpl engine = new ARTCAICallEngineImpl(this, userId);

 // 如果是數字人類型，則需要配置數字人顯示的視圖容器
if (aiAgentType == AvatarAgent) {
    ViewGroup avatarlayer;
    engine.setAgentView(
        avatarlayer,
        new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                                   ViewGroup.LayoutParams.MATCH_PARENT)
    );
}
// 如果是視覺理解類型，則需要配置本地視頻預覽顯示的視圖容器
else if (aiAgentType == VisionAgent) {
    ViewGroup previewLayer;
    engine.setLocalView(previewLayer,
        new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                                     ViewGroup.LayoutParams.MATCH_PARENT)
    );
} else if(aiAgentType == VideoAgent) {
    ARTCAICallEngine.ARTCAICallVideoCanvas remoteCanvas = new ARTCAICallEngine.ARTCAICallVideoCanvas();
            remoteCanvas.zOrderOnTop = false;
            remoteCanvas.zOrderMediaOverlay = false;
    ViewGroup avatarlayer;
    engine.setAgentView(
        avatarlayer,
        new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                                   ViewGroup.LayoutParams.MATCH_PARENT), remoteCanvas
    );

    ViewGroup previewLayer;
    engine.setLocalView(previewLayer,
        new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                                     ViewGroup.LayoutParams.MATCH_PARENT)
    );

}

步驟三：實現回調方法

實現引擎回調，按需實現回調方法。引擎回調介面詳情，請參見API介面詳情。

protected ARTCAICallEngine.IARTCAICallEngineCallback mCallEngineCallback = new ARTCAICallEngine.IARTCAICallEngineCallback() {
    @Override
    public void onErrorOccurs(ARTCAICallEngine.AICallErrorCode errorCode) {
        // 發生了錯誤，結束通話
        engine.handup();
    }

    @Override
    public void onCallBegin() {
        // 通話開始（入會）
    }

    @Override
    public void onCallEnd() {
        // 通話結束（離會）
    }

    @Override
    public void onAICallEngineRobotStateChanged(ARTCAICallEngine.ARTCAICallRobotState oldRobotState, ARTCAICallEngine.ARTCAICallRobotState newRobotState) {
        // 機器人狀態同步
    }

    @Override
    public void onUserSpeaking(boolean isSpeaking) {
        // 使用者說話回調
    }

    @Override
    public void onUserAsrSubtitleNotify(String text, boolean isSentenceEnd, int sentenceId, VoicePrintStatusCode voicePrintStatusCode) {
    
    }

    @Override
    public void onAIAgentSubtitleNotify(String text, boolean end, int userAsrSentenceId) {
        // 同步智能體回應的話
    }

    @Override
    public void onNetworkStatusChanged(String uid, ARTCAICallEngine.ARTCAICallNetworkQuality quality) {
        // 網路狀態回調
    }

    @Override
    public void onVoiceVolumeChanged(String uid, int volume) {
        // 音量變化
    }

    @Override
    public void onVoiceIdChanged(String voiceId) {
        // 當前通話的音色發生了改變
    }

    @Override
    public void onVoiceInterrupted(boolean enable) {
        // 當前通話的語音打斷設定改變
    }

    @Override
    public void onAgentVideoAvailable(boolean available) {
        // 智能體視頻是否可用（推流）
    }

    @Override
    public void onAgentAudioAvailable(boolean available) {
        // 智能體音頻是否可用（推流）
    }

    @Override
    public void onAgentAvatarFirstFrameDrawn() {
        // 數字人首視訊框架渲染
    }

    @Override
    public void onUserOnLine(String uid) {
        // 使用者上線回調
    }

};

engine.setEngineCallback(mCallEngineCallback);

步驟四：建立並初始化ARTCAICallConfig

ARTCAICallConfig詳情，請參見ARTCAICallConfig。

ARTCAICallEngine.ARTCAICallConfig artcaiCallConfig = new ARTCAICallEngine.ARTCAICallConfig();
artcaiCallConfig.agentId = "XXX";            //智能體ID，必填
artcaiCallConfig.region = "cn-shanghai";//智能體地區，必填
artcaiCallConfig.agentType = VoiceAgent;//定智能體的類型：純語音、數字人、視覺理解、視訊通話
engine.init(artcaiCallConfig);

步驟五：發起智能體呼叫

調用call()介面發起智能體呼叫。擷取鑒權Token，請參見產生ARTC鑒權Token。在開啟通話後，您可以根據您的業務需求處理字幕、打斷智能體講話等。詳細內容，請參見功能實現。

engine.call(token);

//接通後，會觸發以下回調
public void onCallBegin() {
        // 通話開始（入會）
}

步驟六：通話中的業務實現

在開啟通話後，您可以根據您的業務需求處理字幕、打斷智能體講話等。詳細內容，請參見功能實現。

步驟七：通話結束，掛斷智能體通話

調用handup()介面，掛斷智能體通話。

engine.handup();