管理用戶端上的通話錄音

重要

此 Azure 通訊服務功能目前處於預覽狀態。 預覽中的功能可供公開使用，而且可供所有新的和現有的Microsoft客戶使用。

此預覽版本沒有服務等級協定，不建議用於處理生產工作負載。 某些功能可能不受支援，或功能可能會受到限制。

如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

通話錄音可讓使用者錄製其使用 Azure 通訊服務進行的通話。 在本文中，您會了解如何管理用戶端上的錄製內容。 開始之前，您必須在伺服器端設定錄製。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 已部署通訊服務資源。 建立通訊服務資源。
• 用來啟用呼叫用戶端的使用者存取權杖。 如需詳細資訊，請參閱建立和管理存取權杖。
• 選擇性：完成快速入門以將語音通話新增至您的應用程式。

支援

下表定義在 Azure 通訊服務 中錄製的支援。

身分識別和通話類型

下表顯示特定通話類型和身分識別的錄製支援。

身分識別	Teams 會議	房間	1:1 通話	群組通話	一對一 Teams Interop 通話	群組 Teams Interop 通話
通訊服務使用者	✔️ [1][2]	✔️ [3]		✔️ [3]		✔️ [2][3]
Microsoft 365 使用者	✔️ [1][2]					✔️ [2][3]

[1] 這些通話類型支援 Teams 雲端。 [2] 這些通話類型支援 Teams 合規性錄製。
[3] 這些通話類型支援 Azure 通訊服務 錄製。

作業

下表顯示通話 SDK 中對個別身分識別類型支援的個別 API。

作業	通訊服務使用者	Microsoft 365 使用者
取得錄製已啟動或停止的通知	✔️	✔️
取得錄製狀態	✔️	✔️
取得錄製完成且可用的通知	✔️ [1]	✔️ [1]
瞭解是否需要明確同意	✔️ [2]	✔️ [2]
明確同意被錄音	✔️ [2]	✔️ [2]

[1] 使用者未收到錄製可用通知。 您可以訂閱 Microsoft Graph 的變更通知，以取得 Teams 雲端錄製可用性的相關通知，或者您可以訂閱 Microsoft.Communication.RecordingFileStatusUpdated Azure 通訊服務 中的事件，以在 Azure 通訊服務 錄製可用時收到通知。

[2] 此功能僅適用於 Teams 會議和群組 Teams 互作性通話。

SDK

下表顯示個別 Azure 通訊服務 SDK 中錄製的支援。

平台	網路	網頁使用者介面	iOS	iOS 使用者介面	安卓	Android 使用者介面 (UI)	窗戶
受支援	✔️	✔️ [1]	✔️ [1]	✔️ [1]	✔️ [1]	✔️ [1]	✔️ [1]

[1] 這些 SDK 不支持明確同意。

安裝 SDK

使用 npm install 命令，安裝適用於 JavaScript 的 Azure 通訊服務通用和通話 SDK：

npm install @azure/communication-common --save
npm install @azure/communication-calling --save

初始化必要的物件

大部分通話作業都需要 CallClient 執行個體。 當您建立新的 CallClient 執行個體時，您可以使用自訂選項加以設定，如同 Logger 執行個體一樣。

使用 CallClient 執行個體，您可以藉由呼叫 CallAgent 來建立 createCallAgent 執行個體。 此方法會以非同步的方式傳回 CallAgent 執行個體物件。

createCallAgent 方法會使用 CommunicationTokenCredential 作為引數。 其接受使用者存取令牌。

您可以使用 getDeviceManager 執行個體上的 CallClient 方法來存取 deviceManager。

const { CallClient } = require('@azure/communication-calling');
const { AzureCommunicationTokenCredential} = require('@azure/communication-common');
const { AzureLogger, setLogLevel } = require("@azure/logger");

// Set the logger's log level
setLogLevel('verbose');

// Redirect log output to console, file, buffer, REST API, or whatever location you want
AzureLogger.log = (...args) => {
    console.log(...args); // Redirect log output to console
};

const userToken = '<USER_TOKEN>';
callClient = new CallClient(options);
const tokenCredential = new AzureCommunicationTokenCredential(userToken);
const callAgent = await callClient.createCallAgent(tokenCredential, {displayName: 'optional Azure Communication Services user name'});
const deviceManager = await callClient.getDeviceManager()

管理與Microsoft基礎結構的 SDK 連線

Call Agent 執行個體可協助您管理通話 (加入或啟動通話)。 若要運作，您的通話 SDK 必須連線到 Microsoft 基礎結構以取得來電通知，並協調其他通話詳細資料。 您的 Call Agent 有兩種可能的狀態：

已連線 - Call Agent 的 Connected connectionStatue 值表示用戶端 SDK 已連線且能夠接收來自 Microsoft 基礎結構的通知。

已中斷連線 - Call Agent 狀態的 Disconnected connectionStatue 值指出有問題導致 SDK 無法正確連線。 Call Agent 應該重新建立。

• invalidToken：如果權杖已過期或無效，Call Agent 執行個體會中斷連線，並出現此錯誤。
• connectionIssue：如果客戶端連線到Microsoft基礎結構時發生問題，在多次重試 Call Agent 后，就會公開 connectionIssue 錯誤。

您可以藉由檢查 Call Agent 屬性的目前值，檢查本機 connectionState 是否已連線到 Microsoft 基礎結構。 在作用中通話期間，您可以接聽 connectionStateChanged 事件，以判斷 Call Agent 是否從已連線變更為已中斷連線狀態。

const connectionState = callAgentInstance.connectionState;
console.log(connectionState); // it may return either of 'Connected' | 'Disconnected'

const connectionStateCallback = (args) => {
    console.log(args); // it will return an object with oldState and newState, each of having a value of either of 'Connected' | 'Disconnected'
    // it will also return reason, either of 'invalidToken' | 'connectionIssue'
}
callAgentInstance.on('connectionStateChanged', connectionStateCallback);

附註

此 API 僅供開發人員預覽，而且可能會根據收到的意見反應變更。 請勿在實際執行環境中使用此 API。 若要使用此 API，請使用 Azure 通訊服務通話 Web SDK 的搶鮮版 (Beta) 版本。

雲端與合規性記錄

通話錄音是核心 Call API 的擴充功能。 您必須先從通話 SDK 匯入通話功能：

import { Features} from "@azure/communication-calling";

然後，您可以從呼叫執行個體取得錄製功能 API 物件：

const callRecordingApi = call.feature(Features.Recording);

若要檢查是否正在記錄通話，請檢查 isRecordingActive 的 callRecordingApi 屬性。 它會傳回 Boolean。

const isRecordingActive = callRecordingApi.isRecordingActive;

您也可以訂閱變更通知：

const isRecordingActiveChangedHandler = () => {
    console.log(callRecordingApi.isRecordingActive);
};

callRecordingApi.on('isRecordingActiveChanged', isRecordingActiveChangedHandler);

您可以使用 recordings 的 callRecordingApi 屬性來取得錄製清單。 它會傳回 RecordingInfo[]，反映雲端錄製的當前狀態。

const recordings = callRecordingApi.recordings;

recordings.forEach(r => {
    console.log("State: ${r.state}");

您也可以訂閱 recordingsUpdated，並取得一系列更新的錄音。 每當有錄製更新時，就會觸發此事件。

const cloudRecordingsUpdatedHandler = (args: { added: SDK.RecordingInfo[], removed: SDK.RecordingInfo[]}) => {
                        console.log('Recording started by: ');
                        args.added?.forEach(a => {
                            console.log('State: ${a.state}');
                        });

                        console.log('Recording stopped by: ');
                        args.removed?.forEach(r => {
                            console.log('State: ${r.state}');
                        });
                    };
callRecordingApi.on('recordingsUpdated', cloudRecordingsUpdatedHandler );

明確同意

當您的 Teams 會議或通話設定為需要明確同意進行錄製和轉譯時，您必須先從通話中的所有參與者收集同意，才能錄製。 您可以在加入會議時主動提供同意，或在錄製開始時主動提供同意。 在明確同意之前，參與者的音訊、視訊和屏幕共用將會在錄製期間停用。

您可以透過 屬性 isTeamsConsentRequired來檢查會議錄製是否需要明確同意。 如果值設定為 true，則 call 需要明確同意。

const isConsentRequired = callRecordingApi.isTeamsConsentRequired;

如果您已經取得用戶的錄製同意，您可以呼叫 grantTeamsConsent() 方法來表示對服務的明確同意。 此同意僅適用於一個 call 會話，如果使用者重新加入會議，則必須再次提供同意。

callRecordingApi.grantTeamsConsent();

啟用音訊、影片或螢幕畫面分享的嘗試會在錄製為作用中時失敗，但尚未提供明確同意。 您可以藉由檢查類別reason的屬性ParticipantCapabilities來辨識此情況，以瞭解功能turnVideoOn、unmuteMic和shareScreen。 您可以在 功能中找到這些功能。call.feature(Features.Capabilities) 這些功能會傳回原因 ExplicitConsentRequired，因為使用者需要提供明確的同意。

安裝 SDK

找到您的項目層級build.gradle檔案，並將mavenCentral()添加到在buildscript和allprojects下的存放庫清單中。

buildscript {
    repositories {
    ...
        mavenCentral()
    ...
    }
}

allprojects {
    repositories {
    ...
        mavenCentral()
    ...
    }
}

然後，在您的模組層級 build.gradle 檔案中，將下列幾行新增至 dependencies 區段：

dependencies {
    ...
    implementation 'com.azure.android:azure-communication-calling:1.0.0'
    ...
}

初始化必要的物件

若要建立 CallAgent 執行個體，您必須在 createCallAgent 執行個體上呼叫 CallClient 方法。 此通話會以非同步方式傳回 CallAgent 執行個體物件。

createCallAgent 方法會採用 CommunicationUserCredential 作為引數，用來封裝存取權杖。

若要存取 DeviceManager，您必須先建立 callAgent 執行個體。 然後，您可以使用 CallClient.getDeviceManager 方法取得 DeviceManager。

String userToken = '<user token>';
CallClient callClient = new CallClient();
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(userToken);
android.content.Context appContext = this.getApplicationContext(); // From within an activity, for instance
CallAgent callAgent = callClient.createCallAgent(appContext, tokenCredential).get();
DeviceManager deviceManager = callClient.getDeviceManager(appContext).get();

若要設定來電者的顯示名稱，請使用下列替代方法：

String userToken = '<user token>';
CallClient callClient = new CallClient();
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(userToken);
android.content.Context appContext = this.getApplicationContext(); // From within an activity, for instance
CallAgentOptions callAgentOptions = new CallAgentOptions();
callAgentOptions.setDisplayName("Alice Bob");
DeviceManager deviceManager = callClient.getDeviceManager(appContext).get();
CallAgent callAgent = callClient.createCallAgent(appContext, tokenCredential, callAgentOptions).get();

錄製通話

附註

此 API 僅供開發人員預覽，而且可能會根據收到的意見反應變更。 請勿在實際執行環境中使用此 API。 若要使用此 API，請使用 Azure 通訊服務通話 Android SDK 的搶鮮版 (Beta) 版本。

通話錄音是核心 Call 物件的擴充功能。

警告

截至 Azure 通訊服務呼叫 Android SDK 的 1.1.0 版和 Beta 版本 1.1.0-Beta.1 為止，isRecordingActive 和 addOnIsRecordingActiveChangedListener 是 Call 物件的一部分。 針對新的測試版 (Beta) 版本，這些 API 已移動為 Call 的延伸功能。

您必須先取得錄製功能物件：

RecordingCallFeature callRecordingFeature = call.feature(Features.RECORDING);

然後，若要檢查是否正在記錄通話，請檢查 isRecordingActive 的 callRecordingFeature 屬性。 它會傳回 boolean。

boolean isRecordingActive = callRecordingFeature.isRecordingActive();

您也可以訂閱變更通知：

private void handleCallOnIsRecordingChanged(PropertyChangedEvent args) {
  boolean isRecordingActive = callRecordingFeature.isRecordingActive();
}

callRecordingFeature.addOnIsRecordingActiveChangedListener(handleCallOnIsRecordingChanged);

如果您想要從您的應用程式開始錄製，請先遵循通話錄音概觀，以取得設定通話錄音的步驟。

在伺服器上設定通話錄音之後，您需要從 Android 應用程式取得通話的 ServerCallId 值，然後將其傳送至您的伺服器，以開始錄製程序。 您可以使用 ServerCallId 類別的 getServerCallId()，找到 CallInfo 值。 您可以使用 CallInfo，在類別物件中找到 getInfo() 類別。

try {
    String serverCallId = call.getInfo().getServerCallId().get();
    // Send serverCallId to your recording server to start the call recording.
} catch (ExecutionException | InterruptedException e) {

} catch (UnsupportedOperationException unsupportedOperationException) {

}

當您從伺服器開始錄製時，會觸發事件 handleCallOnIsRecordingChanged，且 callRecordingFeature.isRecordingActive() 的值是 true。

就像開始通話錄音一樣，如果您想要停止通話錄音，您需要取得 ServerCallId，並將其傳送至錄製伺服器，以便其可以停止錄製：

try {
    String serverCallId = call.getInfo().getServerCallId().get();
    // Send serverCallId to your recording server to stop the call recording.
} catch (ExecutionException | InterruptedException e) {

} catch (UnsupportedOperationException unsupportedOperationException) {

}

當您從伺服器停止錄製時，會觸發事件 handleCallOnIsRecordingChanged，且 callRecordingFeature.isRecordingActive() 的值是 false。

明確同意

附註

此 API 僅供開發人員預覽，而且可能會根據收到的意見反應變更。 請勿在實際執行環境中使用此 API。 若要使用此 API，請使用 Azure 通訊服務通話 Android SDK 的搶鮮版 (Beta) 版本。

當您的 Teams 會議或通話設定為需要明確同意進行錄製和轉譯時，您必須先從通話中的所有參與者收集同意，才能錄製。 您可以在加入會議時主動提供同意，或在錄製開始時主動提供同意。 在明確同意之前，參與者的音訊、視訊和屏幕共用將會在錄製期間停用。

您可以透過 屬性 isTeamsConsentRequired來檢查會議錄製是否需要明確同意。 如果值設定為 true，則 call 需要明確同意。

boolean isConsentRequired = callRecordingFeature.isTeamsConsentRequired();

如果您已經取得用戶的錄製同意，您可以呼叫 grantTeamsConsent() 方法來表示對服務的明確同意。 此同意僅適用於一個 call 會話，如果使用者重新加入會議，則必須再次提供同意。

callRecordingFeature.grantTeamsConsent();

啟用音訊、影片或螢幕畫面分享的嘗試會在錄製為作用中時失敗，但尚未提供明確同意。 您可以藉由檢查類別reason的屬性ParticipantCapabilities來辨識此情況，以瞭解功能turnVideoOn、unmuteMic和shareScreen。 您可以在 功能中找到這些功能。call.feature(Features.Capabilities) 這些功能會傳回原因 ExplicitConsentRequired，因為使用者需要提供明確的同意。

設定你的系統

請遵循下列步驟來設定系統。

建立 Xcode 專案

在 Xcode 中建立新的 iOS 專案，並選取 [單一檢視應用程式] 範本。 本文使用 SwiftUI 架構，因此您應該將 Language 設定為 Swift，並將 Interface 設定為 SwiftUI。

您不會建立本文中的測試。 您可以隨意清除 [包含測試] 核取方塊。

使用 CocoaPods 安裝套件和相依性

1. 為您的應用程式建立 Podfile，如以下範例所示：

   platform :ios, '13.0'
   use_frameworks!
   target 'AzureCommunicationCallingSample' do
       pod 'AzureCommunicationCalling', '~> 1.0.0'
   end
   

2. 執行 pod install。

3. 使用 Xcode 開啟 .xcworkspace。

要求存取麥克風

若要存取裝置的麥克風，您必須使用 NSMicrophoneUsageDescription 更新應用程式的資訊屬性清單。 將相關聯的值設定為字串，其包含在系統用來向使用者要求存取權的對話中。

以滑鼠右鍵按一下專案樹狀結構的 Info.plist 項目，接著選取 [開啟為]>[原始程式碼]。 將以下幾行新增至最上層 <dict> 區段中，然後儲存檔案。

<key>NSMicrophoneUsageDescription</key>
<string>Need microphone access for VOIP calling.</string>

設定應用程式架構

開啟項目的 ContentView.swift 檔案。 將 import 宣告新增至檔案頂端，以匯入 AzureCommunicationCalling 程式庫。 此外，匯入 AVFoundation。 您需要它才能在程式代碼中要求音訊許可權。

import AzureCommunicationCalling
import AVFoundation

初始化 CallAgent

若要從 CallAgent 建立 CallClient 執行個體，您必須使用 callClient.createCallAgent 方法，在 CallAgent 物件初始化後以非同步方式傳回該物件。

若要建立通話用戶端，請傳遞 CommunicationTokenCredential 物件：

import AzureCommunication

let tokenString = "token_string"
var userCredential: CommunicationTokenCredential?
do {
    let options = CommunicationTokenRefreshOptions(initialToken: token, refreshProactively: true, tokenRefresher: self.fetchTokenSync)
    userCredential = try CommunicationTokenCredential(withOptions: options)
} catch {
    updates("Couldn't created Credential object", false)
    initializationDispatchGroup!.leave()
    return
}

// tokenProvider needs to be implemented by Contoso, which fetches a new token
public func fetchTokenSync(then onCompletion: TokenRefreshOnCompletion) {
    let newToken = self.tokenProvider!.fetchNewToken()
    onCompletion(newToken, nil)
}

將您建立的 CommunicationTokenCredential 物件傳遞至 CallClient，並設定顯示名稱：

self.callClient = CallClient()
let callAgentOptions = CallAgentOptions()
options.displayName = " iOS Azure Communication Services User"

self.callClient!.createCallAgent(userCredential: userCredential!,
    options: callAgentOptions) { (callAgent, error) in
        if error == nil {
            print("Create agent succeeded")
            self.callAgent = callAgent
        } else {
            print("Create agent failed")
        }
})

錄製通話

附註

此 API 僅供開發人員預覽，而且可能會根據收到的意見反應變更。 請勿在實際執行環境中使用此 API。 若要使用此 API，請使用 Azure 通訊服務通話 iOS SDK 的搶鮮版 (Beta) 版本。

通話錄音是核心 Call 物件的擴充功能。

警告

截至 Azure 通訊服務呼叫 iOS SDK 的 1.1.0 版和 Beta 版本 1.1.0-Beta.1 為止，isRecordingActive 是 Call 物件的一部分，而 didChangeRecordingState 是 CallDelegate 委派的一部分。 針對新的測試版 (Beta) 版本，這些 API 已移動為 Call 的延伸功能。

您必須先取得錄製功能物件：

let callRecordingFeature = call.feature(Features.recording)

然後，若要檢查是否正在記錄通話，請檢查 isRecordingActive 的 callRecordingFeature 屬性。 它會傳回 Bool。

let isRecordingActive = callRecordingFeature.isRecordingActive;

您也可以使用事件 RecordingCallFeatureDelegate 在類別上實作 didChangeRecordingState 委派來訂閱錄製變更：

callRecordingFeature.delegate = self

// didChangeRecordingState is a member of RecordingCallFeatureDelegate
public func recordingCallFeature(_ recordingCallFeature: RecordingCallFeature, didChangeRecordingState args: PropertyChangedEventArgs) {
    let isRecordingActive = recordingFeature.isRecordingActive
}

如果您想要從您的應用程式開始錄製，請先遵循通話錄音概觀，以取得設定通話錄音的步驟。

在伺服器上設定通話錄音之後，您需要從 iOS 應用程式取得通話的 ServerCallId 值，然後將其傳送至您的伺服器，以開始錄製程序。 您可以使用 ServerCallId 類別的 getServerCallId()，找到 CallInfo 值。 您可以使用 CallInfo，在類別物件中找到 getInfo() 類別。

// Send serverCallId to your recording server to start the call recording.
let serverCallId = call.info.getServerCallId(){ (serverId, error) in }

當您從伺服器開始錄製時，會觸發事件 didChangeRecordingState，且 recordingFeature.isRecordingActive 的值是 true。

就像開始通話錄音一樣，如果您想要停止通話錄音，您需要取得 ServerCallId，並將其傳送至錄製伺服器，以便其可以停止錄製：

// Send serverCallId to your recording server to stop the call recording.
let serverCallId = call.info.getServerCallId(){ (serverId, error) in }

當您從伺服器停止錄製時，會觸發事件 didChangeRecordingState，且 recordingFeature.isRecordingActive 的值是 false。

明確同意

附註

此 API 僅供開發人員預覽，而且可能會根據收到的意見反應變更。 請勿在實際執行環境中使用此 API。 若要使用此 API，請使用 Azure 通訊服務通話 iOS SDK 的搶鮮版 (Beta) 版本。

當您的 Teams 會議或通話設定為需要明確同意進行錄製和轉譯時，您必須先從通話中的所有參與者收集同意，才能錄製。 您可以在加入會議時主動提供同意，或在錄製開始時主動提供同意。 在明確同意之前，參與者的音訊、視訊和屏幕共用將會在錄製期間停用。

您可以透過 屬性 isTeamsConsentRequired來檢查會議錄製是否需要明確同意。 如果值設定為 true，則 call 需要明確同意。

let isConsentRequired = recordingFeature.isTeamsConsentRequired;

如果您已經取得用戶的錄製同意，您可以呼叫 grantTeamsConsent() 方法來表示對服務的明確同意。 此同意僅適用於一個 call 會話，如果使用者重新加入會議，則必須再次提供同意。

recordingFeature.grantTeamsConsent();

啟用音訊、影片或螢幕畫面分享的嘗試會在錄製為作用中時失敗，但尚未提供明確同意。 您可以藉由檢查類別reason的屬性ParticipantCapabilities來辨識此情況，以瞭解功能turnVideoOn、unmuteMic和shareScreen。 您可以在 功能中找到這些功能。call.feature(Features.Capabilities) 這些功能會傳回原因 ExplicitConsentRequired，因為使用者需要提供明確的同意。

設定你的系統

請遵循下列步驟來設定系統。

建立 Visual Studio 專案

針對 通用 Windows 平台 應用程式，請在 Visual Studio 2022 中建立新的空白應用程式 （通用 Windows） 專案。 在輸入專案名稱之後，隨意選擇高於 10.0.17763.0 的任何 Windows SDK。

針對 WinUI 3 應用程式，使用空白應用程式、封裝 (桌面中的 WinUI 3) 範本建立新專案，以設定單頁 WinUI 3 應用程式。 需要 Windows App SDK 1.3 版或更新版本。

使用 NuGet 套件管理員來安裝套件和相依性

通話 SDK API 和程式庫可透過 NuGet 套件公開取得。

若要尋找、下載並安裝呼叫 SDK NuGet 套件：

1. 藉由選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]，開啟 NuGet 套件管理員。
2. 選取 [ 瀏覽]，然後在搜尋方塊中輸入 Azure.Communication.Calling.WindowsClient 。
3. 請確定已選取 [包含發行前版本] 複選框。
4. 選取 Azure.Communication.Calling.WindowsClient 套件，然後選取 [Azure.Communication.Calling.WindowsClient 1.4.0-beta.1] 或更新版本。
5. 選取對應至右窗格上 Azure 通訊服務 項目的複選框。
6. 選取安裝。

錄製通話

通話錄音是核心 Call 物件的擴充功能。 您必須先取得錄製功能物件：

RecordingCallFeature recordingFeature = call.Features.Recording;

然後，若要檢查是否正在記錄通話，請檢查 IsRecordingActive 的 recordingFeature 屬性。 它會傳回 boolean。

boolean isRecordingActive = recordingFeature.IsRecordingActive;

您也可以訂閱變更通知：

private async void Call__OnIsRecordingActiveChanged(object sender, PropertyChangedEventArgs args)
  boolean isRecordingActive = recordingFeature.IsRecordingActive;
}

recordingFeature.IsRecordingActiveChanged += Call__OnIsRecordingActiveChanged;

明確同意

附註

此 API 僅供開發人員預覽，而且可能會根據收到的意見反應變更。 請勿在實際執行環境中使用此 API。 若要使用此 API，請使用 Azure 通訊服務呼叫 Windows SDK 的 Beta 版本。

當您的 Teams 會議或通話設定為需要明確同意進行錄製和轉譯時，您必須先從通話中的所有參與者收集同意，才能錄製。 您可以在加入會議時主動提供同意，或在錄製開始時主動提供同意。 在明確同意之前，參與者的音訊、視訊和屏幕共用將會在錄製期間停用。

您可以透過 屬性 isTeamsConsentRequired來檢查會議錄製是否需要明確同意。 如果值設定為 true，則 call 需要明確同意。

boolean isConsentRequired = recordingFeature.isTeamsConsentRequired;

如果您已經取得用戶的錄製同意，您可以呼叫 grantTeamsConsent() 方法來表示對服務的明確同意。 此同意僅適用於一個 call 會話，如果使用者重新加入會議，則必須再次提供同意。

recordingFeature.grantTeamsConsent();

啟用音訊、影片或螢幕畫面分享的嘗試會在錄製為作用中時失敗，但尚未提供明確同意。 您可以藉由檢查類別reason的屬性ParticipantCapabilities來辨識此情況，以瞭解功能turnVideoOn、unmuteMic和shareScreen。 您可以在 功能中找到這些功能。call.feature(Features.Capabilities) 這些功能會傳回原因 ExplicitConsentRequired，因為使用者需要提供明確的同意。

SDK 相容性

下表顯示支援個別 API 的最低 SDK 版本。

作業	網路	網頁使用者介面	iOS	iOS 使用者介面	安卓	Android 使用者介面 (UI)	窗戶
取得錄製已啟動或停止的通知	1.0.0、1.25.3-beta.1	1.0.0、1.15.0-beta.1	2.0.0、2.1.0-beta.1	1.0.0、1.15.0-beta.1	2.0.0、1.2.0-beta.1	1.0.0、1.15.0-beta.1	1.0.0、1.0.0-beta.31
取得錄製狀態	1.0.0、1.25.3-beta.1	1.0.0、1.15.0-beta.1	2.0.0、2.1.0-beta.1	1.0.0、1.15.0-beta.1	2.0.0、1.2.0-beta.1	1.0.0、1.15.0-beta.1	1.0.0、1.0.0-beta.31
瞭解是否需要明確同意	1.31.2、1.32.1-beta.1	❌	2.16.0-beta.1	❌	2.14.0-beta.1	❌	1.12.0-beta.1
明確同意被錄音	1.31.2、1.32.1-beta.1	❌	2.16.0-beta.1	❌	2.14.0-beta.1	❌	1.12.0-beta.1

下一步

• 了解如何管理通話
• 了解如何管理影片
• 了解如何轉譯通話