Zobrazení stavu přepisu volání v klientovi

Před tím, než je budete moct přepisovat, musíte shromáždit souhlas všech účastníků hovoru. Microsoft Teams umožňuje uživatelům zahájit přepis schůzek nebo hovorů. Při spuštění přepisu se zobrazí událost. Stav přepisu můžete zkontrolovat, pokud se přepis spustil před tím, než jste se připojili k hovoru nebo schůzce. Pokud schůzka nebo hovor vyžadují přepis, můžete poskytnout explicitní souhlas, pokud jste jej již shromáždili.

Požadavky

Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
Nasazený zdroj komunikačních služeb. Vytvořte zdroj služeb komunikace.
Uživatelský přístupový token k povolení volání klienta. Další informace naleznete v části Vytvoření a správa přístupových tokenů.
Volitelné: Dokončením rychlého startu přidáte do aplikace hlasové hovory.

Podpora

Následující tabulky definují podporu přepisu volání ve službě Azure Communication Services.

Identifikátory a typy volání

Následující tabulky ukazují podporu přepisu pro konkrétní typ volání a identitu.

Identity	Schůzka v Microsoft Teams	Místnost	hovor jeden na jednoho	Skupinový hovor	1:1 hovor o interoperabilitě v Teams	Skupinový hovor pro interoperabilitu v aplikaci Teams
Uživatel komunikačních služeb	✔️				✔️	✔️
Uživatel Microsoftu 365	✔️				✔️	✔️

Provozní činnosti

Následující tabulky ukazují podporu jednotlivých rozhraní API při volání sady SDK k jednotlivým typům identit.

Provozní činnosti	Uživatel komunikačních služeb	Uživatel Microsoftu 365
Získání události, která zahájila přepis	✔️	✔️
Získání stavu přepisu	✔️	✔️
Spuštění nebo zastavení přepisu
Informace o tom, jestli je vyžadován explicitní souhlas	✔️ [1]	✔️ [1]
Udělení výslovného souhlasu s přepisem	✔️ [1]	✔️ [1]

[1] Tato funkce je dostupná pouze při schůzkách Teams a skupinových hovorech interoperability v rámci Teams.

SDKy

Následující tabulky ukazují podporu přepisu v jednotlivých sadách SDK služeb Azure Communication Services.

Platformy	web	Webové uživatelské rozhraní	iOS	Uživatelské rozhraní iOS	Android	Uživatelské rozhraní Androidu	Windows
Je podporováno.	✔️	✔️ [1]	✔️ [1]	✔️ [1]	✔️ [1]	✔️ [1]	✔️ [1]

[1] Tyto sady SDK nepodporují explicitní souhlas.

Nainstalujte SDK

Pomocí příkazu npm install nainstalujte Azure Communication Services Common and Calling SDK pro JavaScript:

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

Inicializace požadovaných objektů

Instance CallClient je vyžadována pro většinu operací volání. Když vytvoříte novou instanci CallClient, můžete ji nakonfigurovat pomocí vlastních možností, jako je instance Logger.

S instancí CallClient můžete vytvořit instanci CallAgent zavoláním createCallAgent. Tato metoda asynchronně vrací objekt instance CallAgent.

Metoda createCallAgent používá CommunicationTokenCredential jako argument. Přijímá přístupový token uživatele.

Můžete použít metodu getDeviceManager na instanci CallClient pro přístup k 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()

Správa připojení sady SDK k infrastruktuře Microsoftu

Instance Call Agent vám pomáhá spravovat hovory (pro připojení nebo zahájení hovorů). Aby vaše SDK pro volání fungovalo, musí se připojit k infrastruktuře Microsoftu, aby přijímalo oznámení o příchozích hovorech a koordinovalo další podrobnosti hovoru. Vaše Call Agent má dva možné stavy:

Připojeno – Call Agent Hodnota connectionStatue znamená, Connected že klientská sada SDK je připojená a dokáže přijímat oznámení z infrastruktury Microsoftu.

Odpojeno – Hodnota Call AgentDisconnected connectionStatue uvádí, že existuje problém, který brání tomu, aby se SDK správně připojilo. Call Agent by měl být znovu vytvořen.

invalidToken: Pokud je token vypršelý nebo neplatný, instance Call Agent se s tímto chybovým hlášením odpojí.
connectionIssue: Pokud dojde k problému s klientem, který se připojuje k infrastruktuře Microsoftu, po mnoha opakovaných pokusech Call Agent zveřejní chybu connectionIssue.

Můžete zkontrolovat, zda je vaše místní Call Agent připojeno k infrastruktuře Microsoftu, tím, že prozkoumáte aktuální hodnotu vlastnosti connectionState. Během aktivního volání můžete naslouchat události connectionStateChanged a zjistit, jestli se Call Agent změní ze stavu Připojeno do stavu Odpojeno.

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);

Výstraha

Kvůli změnám v Microsoft Teams zastaví SDK pro JavaScript ve verzích 1.21 a nižších přepis v Teams a brání uživatelům Teams ve spuštění přepisu. Pokud chcete v hovorech a schůzkách používat přepis Teams, musíte upgradovat sadu SDK pro volání na minimálně verzi 1.22.

Přepis hovoru

Transcription je rozšířená funkce třídy Call. Nejprve potřebujete získat objekt API funkce pro přepis.

const callTranscriptionFeature = call.feature(Features.Transcription);

Můžete zkontrolovat stav přepisu ve vlastnosti isTranscriptionActive. Pokud je hodnota nastavená na true, je přepis aktivní.

const isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive;

Můžete se přihlásit k odběru události, která se aktivuje při změně stavu přepisu:

const isTranscriptionActiveChangedHandler = () => {
  console.log(callTranscriptionFeature.isTranscriptionActive);
};
callTranscriptionFeature.on('isTranscriptionActiveChanged', isTranscriptionActiveChangedHandler);

Od odběru události se můžete odhlásit následujícím kódem:

callTranscriptionFeature.off('isTranscriptionActiveChanged', isTranscriptionActiveChangedHandler);

Pokud je schůzka nebo hovor v Teams nakonfigurovaný tak, aby vyžadoval explicitní souhlas se záznamem nebo přepisem, musíte od uživatelů shromáždit explicitní souhlas, abyste uživatelům umožnili přepisovat nebo zaznamenávat. Souhlas můžete poskytnout aktivně při připojování ke schůzce nebo dodatečně, když začne záznam nebo přepis. Dokud explicitní souhlas neudělíte, během přepisu se zakáže zvuk, video a sdílení obrazovky účastníků.

Můžete zkontrolovat, jestli přepis schůzky vyžaduje explicitní souhlas podle vlastnosti isTeamsConsentRequired. Pokud je hodnota nastavena na true, pak explicitní souhlas je vyžadován pro call.

const isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired;

Pokud jste již získali souhlas uživatele s přepisem, můžete volat metodu grantTeamsConsent(), která označuje výslovný souhlas s poskytnutím služby. Tento souhlas platí jenom pro jednu call relaci a uživatelé musí znovu poskytnout souhlas, pokud se znovu připojí ke schůzce.

callTranscriptionFeature.grantTeamsConsent();

Pokusy o povolení sdílení zvuku, videa nebo obrazovky selžou, když je přepis aktivní, vyžaduje se explicitní souhlas, ale ještě není zadaný. Tuto situaci můžete rozpoznat tak, že zkontrolujete vlastnost reason třídy ParticipantCapabilities pro schopnostiturnVideoOn, unmuteMic a shareScreen. Tyto funkce najdete v této funkci call.feature(Features.Capabilities). Tyto funkce by vrátily důvod ExplicitConsentRequired , protože uživatelé potřebují poskytnout explicitní souhlas.

Nainstalujte SDK

Vyhledejte soubor na úrovni projektu build.gradle a do seznamu úložišť přidejte mavenCentral() pod buildscript a allprojects:

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

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

Potom do souboru na úrovni build.gradle modulu přidejte do oddílu dependencies následující řádky:

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

Inicializujte požadované objekty

Pro vytvoření instance CallAgent musíte zavolat metodu createCallAgent na instanci CallClient. Toto volání asynchronně vrátí CallAgent objekt instance.

Metoda createCallAgent přijímá CommunicationUserCredential jako argument, který obsahuje přístupový token.

Chcete-li získat přístup k DeviceManager, musíte nejprve vytvořit instanci callAgent. Poté můžete použít metodu CallClient.getDeviceManager, abyste získali 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();

Chcete-li nastavit zobrazované jméno pro volajícího, použijte tuto alternativní metodu:

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();

Výstraha

Až do verze 1.1.0 a beta verze 1.1.0-beta.1 byly součástí objektu isTranscriptionActive komponenty addOnIsTranscriptionActiveChangedListener a Call sady Azure Communication Services Volání pro Android SDK. U nových beta verzí jsou teď tyto funkce rozšířenou funkcí Call , jak je popsáno dále v tomto článku.

Přepis volání je rozšířená funkce základního Call objektu. Nejprve musíte získat objekt funkce přepisu:

TranscriptionCallFeature callTranscriptionFeature = call.feature(Features.TRANSCRIPTION);

Potom zkontrolujte, jestli se hovor přepisuje, zkontrolujte isTranscriptionActive vlastnost callTranscriptionFeature. Vrátí boolean.

boolean isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive();

Můžete se také přihlásit k odběru změn v přepisu:

private void handleCallOnIsTranscriptionChanged(PropertyChangedEvent args) {
    boolean isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive();
}

callTranscriptionFeature.addOnIsTranscriptionActiveChangedListener(handleCallOnIsTranscriptionChanged);

Poznámka:

Toto rozhraní API je poskytováno jako verze Preview pro vývojáře a může se měnit na základě zpětné vazby, kterou obdržíme. Toto rozhraní API nepoužívejte v produkčním prostředí. Chcete-li použít toto rozhraní API, použijte beta verzi Azure Communication Services Calling SDK pro Android.

Můžete zkontrolovat, jestli přepis schůzky vyžaduje explicitní souhlas podle vlastnosti isTeamsConsentRequired(). Pokud je hodnota nastavena na true, pak explicitní souhlas je vyžadován pro call.

boolean isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired();

callTranscriptionFeature.grantTeamsConsent();

Nastavení systému

Proveďte tyto kroky k nastavení vašeho systému.

Vytvořte projekt Xcode

V Xcode vytvořte nový projekt iOS a vyberte šablonu Single View App. Tento článek používá architekturu SwiftUI, takže byste měli nastavit jazyk na Swift a nastavit rozhraní na SwiftUI.

V tomto článku nebudete vytvářet testy. Nebojte se odškrtnout políčko Include Tests.

Snímek obrazovky, který ukazuje okno pro vytváření projektu v Xcode.

Nainstalujte balíček a závislosti pomocí CocoaPods.

Vytvořte Podfile pro vaši aplikaci, jako v tomto příkladu:

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

Spusťte pod install.
Otevřete .xcworkspace pomocí Xcode.

Požádejte o přístup k mikrofonu

Chcete-li přistupovat k mikrofonu zařízení, musíte aktualizovat seznam vlastností informací vaší aplikace pomocí NSMicrophoneUsageDescription. Nastavte přidruženou hodnotu na řetězec, který je součástí dialogového okna, které systém používá k vyžádání přístupu od uživatele.

Klikněte pravým tlačítkem na položku Info.plist ve stromovém zobrazení projektu a poté vyberte Otevřít jako>Zdrojový kód. Přidejte následující řádky do sekce <dict> na nejvyšší úrovni a poté soubor uložte.

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

Nastavte rámec aplikace

Otevřete soubor ContentView.swift vašeho projektu. Přidejte deklaraci import na začátek souboru pro import knihovny AzureCommunicationCalling. Navíc importujte AVFoundation. Potřebujete to ke zpracování žádostí o povolení zvuku v kódu.

import AzureCommunicationCalling
import AVFoundation

Inicializujte CallAgent

Chcete-li vytvořit CallAgent instanci z CallClient, musíte použít metodu callClient.createCallAgent , která asynchronně vrátí CallAgent objekt po inicializaci.

Pokud chcete vytvořit klienta volání, předejte CommunicationTokenCredential objekt:

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)
}

Objekt CommunicationTokenCredential, který jste vytvořili, předejte do CallClient a nastavte zobrazovaný název:

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")
        }
})

Výstraha

Až do verze 1.1.0 a beta verze 1.1.0-beta.1 má iOS SDK služby Azure Communication Services isTranscriptionActive jako součást objektu Call, zatímco didChangeTranscriptionState je součástí delegáta CallDelegate. U nových beta verzí jsou teď tyto funkce rozšířenou funkcí Call , jak je popsáno dále v tomto článku.

Přepis volání je rozšířená funkce základního Call objektu. Nejprve musíte získat objekt funkce přepisu:

let callTranscriptionFeature = call.feature(Features.transcription)

Pokud chcete zkontrolovat, jestli je hovor přepsán, zkontrolujte isTranscriptionActive vlastnost callTranscriptionFeature. Vrátí Bool.

let isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive;

Také se můžete přihlásit k odběru změn přepisu prostřednictvím implementace TranscriptionCallFeatureDelegate delegáta ve své třídě s událostí didChangeTranscriptionState.

callTranscriptionFeature.delegate = self

// didChangeTranscriptionState is a member of TranscriptionCallFeatureDelegate
public func transcriptionCallFeature(_ transcriptionCallFeature: TranscriptionCallFeature, didChangeTranscriptionState args: PropertyChangedEventArgs) {
    let isTranscriptionActive = callTranscriptionFeature.isTranscriptionActive
}

Poznámka:

Toto rozhraní API je poskytováno jako verze Preview pro vývojáře a může se měnit na základě zpětné vazby, kterou obdržíme. Toto rozhraní API nepoužívejte v produkčním prostředí. Pokud chcete toto rozhraní API použít, použijte beta verzi sady Azure Communication Services Call iOS SDK.

let isTranscriptionConsentRequired = callTranscriptionFeature.isTeamsConsentRequired;

callTranscriptionFeature.grantTeamsConsent();

Nastavení systému

Proveďte tyto kroky k nastavení vašeho systému.

Vytvořte projekt ve Visual Studiu.

Vytvořte v sadě Visual Studio 2022 nový projekt Blank App (Universal Windows) pro aplikaci na Univerzální platformě Windows. Po zadání názvu projektu můžete vybrat libovolný Windows SDK novější než 10.0.17763.0.

V případě aplikace WinUI 3 vytvořte nový projekt pomocí šablony Prázdná aplikace zabalená (WinUI 3 v desktopové verzi) pro nastavení jednostráňové aplikace WinUI 3. Windows App SDK verze 1.3 nebo novější je vyžadována.

Nainstalujte balíček a závislosti pomocí Správce balíčků NuGet

Rozhraní API a knihovny Calling SDK jsou k dispozici veřejnosti prostřednictvím balíčku NuGet.

Chcete-li najít, stáhnout a nainstalovat balíček Calling SDK NuGet:

Otevřete Správce balíčků NuGet výběrem Nástroje>Správce balíčků NuGet>Správa balíčků NuGet pro řešení.
Vyberte Procházet a do vyhledávacího pole zadejte Azure.Communication.Calling.WindowsClient .
Ujistěte se, že je zaškrtnuté políčko Zahrnout předběžné verze .
Vyberte balíček Azure.Communication.Calling.WindowsClient a pak vyberte Azure.Communication.Calling.WindowsClient1.4.0-beta.1 nebo novější verzi.
Zaškrtněte políčko odpovídající projektu Azure Communication Services v pravém podokně.
Vyberte volbu Instalovat.

Přepis volání je rozšířená funkce základního Call objektu. Nejprve musíte získat objekt funkce přepisu:

TranscriptionCallFeature transcriptionFeature = call.Features.Transcription;

Potom zkontrolujte, jestli se hovor přepisuje, zkontrolujte IsTranscriptionActive vlastnost transcriptionFeature. Vrátí boolean.

boolean isTranscriptionActive = transcriptionFeature.isTranscriptionActive;

Můžete se také přihlásit k odběru změn v přepisu:

private async void Call__OnIsTranscriptionActiveChanged(object sender, PropertyChangedEventArgs args)
    boolean isTranscriptionActive = transcriptionFeature.IsTranscriptionActive();
}

transcriptionFeature.IsTranscriptionActiveChanged += Call__OnIsTranscriptionActiveChanged;

Poznámka:

Toto rozhraní API je poskytováno jako verze Preview pro vývojáře a může se měnit na základě zpětné vazby, kterou obdržíme. Toto rozhraní API nepoužívejte v produkčním prostředí. K použití tohoto rozhraní API použijte beta verzi Azure Communication Services Calling Windows SDK.

boolean isTranscriptionConsentRequired = transcriptionFeature.isTeamsConsentRequired;

transcriptionFeature.grantTeamsConsent();

Kompatibilita sady SDK

Následující tabulka uvádí minimální verzi sad SDK, které podporují jednotlivá rozhraní API.

Provozní činnosti	web	Webové uživatelské rozhraní	iOS	Uživatelské rozhraní iOS	Android	Uživatelské rozhraní Androidu	Windows
Získání události, která zahájila přepis	1.0.0, 1.25.3-beta.1	1.0.0, 1.0.0-beta.8	2.1.0, 2.1.0-beta.1	1.0.0, 1.0.0-beta.8	1.1.0, 1.2.0-beta.1	1.0.0, 1.0.0-beta.8	1.0.0, 1.0.0-beta.31
Získání stavu přepisu	1.0.0, 1.25.3-beta.1	1.0.0, 1.0.0-beta.8	2.1.0, 2.1.0-beta.1	1.0.0, 1.0.0-beta.8	1.1.0, 1.2.0-beta.1	1.0.0, 1.0.0-beta.8	1.0.0, 1.0.0-beta.31
Informace o tom, jestli je vyžadován explicitní souhlas	1.31.2, 1.32.1-beta.1	❌	2.16.0-beta.1	❌	2.14.0-beta.1	❌	1.12.0-beta.1
Udělení výslovného souhlasu pro zaznamenání	1.31.2, 1.32.1-beta.1	❌	2.16.0-beta.1	❌	2.14.0-beta.1	❌	1.12.0-beta.1

Další kroky

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-06-19

Sdílet prostřednictvím

Zobrazení stavu přepisu volání v klientovi

Požadavky

Podpora

Identifikátory a typy volání

Provozní činnosti

SDKy

Nainstalujte SDK

Inicializace požadovaných objektů

Správa připojení sady SDK k infrastruktuře Microsoftu

Přepis hovoru

Explicitní souhlas

Nainstalujte SDK

Inicializujte požadované objekty

Explicitní souhlas

Nastavení systému

Vytvořte projekt Xcode

Nainstalujte balíček a závislosti pomocí CocoaPods.

Požádejte o přístup k mikrofonu

Nastavte rámec aplikace

Inicializujte CallAgent

Explicitní souhlas

Nastavení systému

Vytvořte projekt ve Visual Studiu.

Nainstalujte balíček a závislosti pomocí Správce balíčků NuGet

Explicitní souhlas

Kompatibilita sady SDK

Další kroky

Váš názor

Další materiály