隱藏式輔助字幕

隱藏式輔助字幕在視訊語音通話應用程式中扮演重要角色，能提供許多優點，可增強這些平台的協助工具、可用性和整體使用者體驗。

在本文中，您將了解如何使用 UI 程式庫啟用隱藏式輔助字幕案例。 有兩個主要案例可啟用隱藏式輔助字幕：Azure 通訊服務視訊和語音通話以及 Interop 通話。

Azure 通訊服務隱藏式輔助字幕

僅支援涉及 Azure 通訊服務使用者的通話。 目前，Azure 通訊服務輔助字幕不支援語言翻譯。

Teams Interop 隱藏式輔助字幕

在與一或多個 Teams 使用者的通話期間支援。

翻譯支援

不同於 Azure 通訊服務隱藏式輔助字幕，Teams Interop 隱藏式輔助字幕支援翻譯。 使用者可以選擇透過輔助字幕設定將隱藏式輔助字幕翻譯成不同的語言。

如何使用輔助字幕

輔助字幕會在 CallingUILibrary 內緊密整合。

1. 啟用輔助字幕：

   • 在連線的通話期間，瀏覽至控制列，然後按一下 [更多] 按鈕。
   • 在功能表快顯中，切換為開啟輔助字幕。

2. 調整口語語言：

   • 如果在會議中使用不同的語言，使用者可以透過 UI 變更口語語言。 這項變更適用於通話中的所有使用者。

3. 設定輔助字幕語言 (適用於 Teams Interop 隱藏式輔助字幕)：

   • 根據預設，即時輔助字幕會顯示在會議或活動口語語言中。 即時翻譯的輔助字幕可讓使用者看到翻譯成他們最熟悉語言的輔助字幕。
   • 如果需要翻譯成不同的語言，請在輔助字幕開始後按一下 [輔助字幕語言] 按鈕來變更輔助字幕語言。

注意

會議中即時翻譯的輔助字幕僅做為 Teams Premium 的一部分提供使用，這是附加元件授權，可提供額外的功能，使 Teams 會議更加個人化、智慧且安全。 若要存取 Teams Premium，請連絡您的 IT 系統管理員。您可以在這裡找到更多詳細資料。

支援的語言

Azure 通訊服務支援各種輔助字幕的口語語言。 下表包含可搭配 setSpokenLanguage 方法使用的支援語言代碼清單，可設定輔助字幕所需的語言。

語言	ACS 口語代碼	Teams 口語代碼	Teams 輔助字幕代碼
阿拉伯文	ar-ae、ar-sa	ar-ae、ar-sa	ar
丹麥文	da-dk	da-dk	da
德文	de-de	de-de	de
英語	en-au、en-ca、en-gb、en-in、en-nz、en-us	en-au、en-ca、en-gb、en-in、en-nz、en-us	en
西班牙文	es-es、es-mx	es-es、es-mx	es
芬蘭文	fi-fi	fi-fi	fi
法文	fr-ca、fr-fr	fr-ca、fr-fr	fr、fr-ca
印度文	hi-in	hi-in	hi
義大利文	it-it	it-it	it
日文	ja-jp	ja-jp	ja
韓文	ko-kr	ko-kr	ko
挪威文	nb-no	nb-no	nb
荷蘭文	nl-be、nl-nl	nl-be、nl-nl	nl
波蘭文	pl-pl	pl-pl	pl
葡萄牙文	pt-br	pt-br、pt-pt	pt、pt-pt
俄文	ru-ru	ru-ru	ru
瑞典文	sv-se	sv-se	sv
中文	zh-cn、zh-hk	zh-cn、zh-hk	zh-Hans、zh-Hant
捷克文	-	cs-cz	cs
斯洛伐克文	-	sk-sk	sk
土耳其文	-	tr-tr	tr
越南文	-	vi-vn	vi
泰文	-	th-th	th
希伯來文	-	he-il	he
威爾斯文	-	cy-gb	cy
烏克蘭文	-	uk-ua	uk
希臘文	-	el-gr	el
匈牙利文	-	hu-hu	hu
羅馬尼亞文	-	ro-ro	ro

確定選取的口語語言符合通話中使用的語言，以正確產生輔助字幕。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 已部署通訊服務資源。 建立通訊服務資源。
• 用來啟用通話用戶端的使用者存取權杖。 取得使用者存取權杖。
• 選擇性：完成開始使用 UI 程式庫複合的快速入門。

設定功能

啟用隱藏式輔助字幕

setCaptionsOn 方法預設會設定為啟動輔助字幕。

Kotlin

val captionsOptions = CallCompositeCaptionsOptions()
captionsOptions.setCaptionsOn(true)
captionsOptions.setSpokenLanguage("en-US")

val localOptions = CallCompositeLocalOptions()
localOptions.setCaptionsOptions(captionsOptions)

Java

CallCompositeCaptionsOptions captionsOptions = new CallCompositeCaptionsOptions();
captionsOptions.setCaptionsOn(true);
captionsOptions.setSpokenLanguage("en-us");

CallCompositeLocalOptions localOptions = new CallCompositeLocalOptions();
localOptions.setCaptionsOptions(captionsOptions);

啟用隱藏式輔助字幕

captionsOn 方法預設會設定為啟動輔助字幕。

let captionsOptions = CaptionsOptions(
    captionsOn: true, 
    spokenLanguage: "en-US"
)

let localOptions = LocalOptions(
    participantViewData: participantViewData,
    setupScreenViewData: setupScreenViewData,
    cameraOn: false,
    microphoneOn: false,
    skipSetupScreen: false,
    audioVideoMode: .audioAndVideo,
    captionsOptions: captionsOptions
)

下一步

• 深入了解 UI 程式庫