Intelligent Media Services：已知問題及解決方案

Ark-TS問題

1. 不要使用Map去自動建立對象

   //SDK介面
   public playAudioEffect(soundId: number, filePath: string, config: AliRtcAudioEffectConfig): numbe
   
   //ts用map建立對象
   //由於map對象無法在c++匹配到對象，會導致crash
   this.rtcSdk?.playAudioEffect(1, "test", {
               needPublish: true,
               loopCycles: 0,
               startPosMs: 0,
               publishVolume: 0,
               playoutVolume: 0
             } );
   
   //建議使用方式
   let config = new AliRtcAudioEffectConfig();
   config.needPublish = 0;
   config.loopCycles = 0;
   config.startPosMs = 0;
   config.publishVolume = 0;
   config.playoutVolume = 0;
   this.rtcSdk?.playAudioEffect(1, "test", config);

2. SDK暴露出來的類型請嚴格傳入

   如：AliRtcAudioEffectConfig的loopCycles是number類型，請勿傳入string類型，會導致轉換失敗，影響商務邏輯。

音頻問題

1. 通話過程中，無法切換擴音器和耳機

   HarmonyOS NEXT系統暫時沒有提供使用者可以手動切換擴音器和耳機的 API 介面。待後續功能支援後最佳化。

2. 反覆進出通話過程，可能出現無法播放器聲音的情況

   由於HarmonyOS NEXT系統問題，偶爾出現音頻播放不出聲音情況。遇到這種情況後，先嘗試重啟手機後再做嘗試。

3. 使用typeC to 3.5mm介面 + 3.5mm三環線的耳機，會觸發會議情境音頻紊亂

   HarmonyOS NEXT系統在使用typeC to 3.5mm介面 + 3.5mm三環線時，會觸發系統音頻紊亂問題，需要重啟手機解決。暫不建議通過typeC to 3.5mm + 耳機的方式使用。

視頻問題

1. App 應用切回前台，預覽畫面閃爍

由於進入後台HarmonyOS NEXT系統會禁止使用網路攝影機採集視頻，因此App切回前台需重新啟動攝像，因此會畫面閃爍，待後續最佳化。

效能問題

1. 快速重複建立銷毀引擎，偶現ANR

   請不要在回調方法中，調用RTC的API。建議平台層做快速切換保護。

   由於HarmonyOS NEXT上層使用TS引擎，上層只有一個線程，如果剛剛在回調資料過程，調用Native API，有機率導致ANR。正在跟鴻蒙方溝通最佳化方案，已知問題，持續最佳化中。

2. 事件回調不及時

   建議減少回調監聽的註冊，按需做回調監聽。

   原因同上，由於Native回調到平台層，必須回到主線程，導致回調必須等待上一個回調執行完畢，因此，部分回調的回調時機，不如Android/iOS平台及時。正在跟鴻蒙方溝通最佳化方案。

資料回調問題

1. 暫時不提供錄製視頻資料、音頻資料等未經處理資料介面

   由於回調到平台層，必須回到主線程。在主線程對錄製的視頻資料、音頻資料做前處理，會導致主線程被卡住，進而導致ANR。因此，本期暫不提供未經處理資料介面方案。