Deelnemen aan een teamsvergadering

Met Azure Communication Services-SDK's kunnen uw gebruikers deelnemen aan regelmatige Vergaderingen in Microsoft Teams. Dit doet u als volgt.

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken
• Een geïmplementeerde Communication Services-resource. Een Communication Services-resource maken.
• Een gebruikerstoegangstoken om de aanroepende client in te schakelen. Zie Toegangstokens maken en beheren voor meer informatie.
• Optioneel: Voltooi de quickstart om spraakgesprekken toe te voegen aan uw toepassing

Installeer de SDK

Gebruik de npm install opdracht om de Common and Calling SDK voor Azure Communication Services voor JavaScript te installeren:

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

Vereiste objecten initialiseren

Een CallClient exemplaar is vereist voor de meeste aanroepbewerkingen. Wanneer u een nieuw CallClient exemplaar maakt, kunt u deze configureren met aangepaste opties, zoals een Logger exemplaar.

Met het CallClient exemplaar kunt u een CallAgent exemplaar maken door het createCallAgentaan te roepen. Deze methode retourneert asynchroon een CallAgent exemplaarobject.

De createCallAgent methode gebruikt CommunicationTokenCredential als argument. Het accepteert een toegangstoken van een gebruiker.

U kunt de getDeviceManager methode op het CallClient exemplaar gebruiken om toegang te krijgen tot 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()

Sdk-connectiviteit met Microsoft-infrastructuur het beste beheren

Het Call Agent exemplaar helpt u bij het beheren van gesprekken (om aanroepen deel te nemen of te starten). Als u wilt werken met uw aanroepende SDK, moet u verbinding maken met de Microsoft-infrastructuur om meldingen van binnenkomende oproepen te ontvangen en andere gespreksgegevens te coördineren. Uw Call Agent heeft twee mogelijke statussen:

Verbonden : een Call Agent connectionStatue-waarde van Connected het middel dat de client-SDK is verbonden en meldingen van de Microsoft-infrastructuur kan ontvangen.

Verbinding verbroken - Een Call Agent connectionStatue-waarde van Disconnected statussen is er een probleem dat verhindert dat de SDK verbinding maakt. Call Agent moet opnieuw worden gemaakt.

• invalidToken: Als een token is verlopen of een ongeldig exemplaar Call Agent wordt verbroken met deze fout.
• connectionIssue: Als er een probleem is met de client die verbinding maakt met Microsoft infrascture, wordt de connectionIssue fout na veel nieuwe pogingen Call Agent weergegeven.

U kunt controleren of uw lokale Call Agent verbinding heeft met de Microsoft-infrastructuur door de huidige waarde van connectionState de eigenschap te controleren. Tijdens een actieve oproep kunt u naar de connectionStateChanged gebeurtenis luisteren om te bepalen of Call Agent de status Verbonden naar Verbroken is gewijzigd.

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

Methoden voor deelname aan vergadering

Als u wilt deelnemen aan een Teams-vergadering, gebruikt u de join methode en geeft u een koppeling naar een vergadering of coördinaten van een vergadering door.

Deelnemen via een koppeling naar een vergadering:

const locator = { meetingLink: '<MEETING_LINK>'}
const call = callAgent.join(locator);

Deelnemen met behulp van vergaderingcoördinaten (dit is momenteel in beperkte preview):

const locator = {
    threadId: <thread id>,
    organizerId: <organizer id>,
    tenantId: <tenant id>,
    messageId: <message id>
}
const call = callAgent.join(locator);

Uw systeem instellen

Volg deze stappen om uw systeem in te stellen.

Het Visual Studio-project maken

Voor een Universeel Windows-platform-app maakt u in Visual Studio 2022 een nieuw leeg app-project (Universal Windows). Nadat u de projectnaam hebt ingevoerd, kunt u een Windows SDK kiezen die hoger is dan 10.0.17763.0.

Maak voor een WinUI 3-app een nieuw project met de sjabloon Blank App, Packaged (WinUI 3 in Desktop) om een WinUI 3-app met één pagina in te stellen. Windows-app SDK versie 1.3 of hoger is vereist.

Installeer het pakket en afhankelijkheden met behulp van NuGet Pakketbeheer

De Aanroepende SDK-API's en -bibliotheken zijn openbaar beschikbaar via een NuGet-pakket.

Het NuGet-pakket voor aanroepende SDK zoeken, downloaden en installeren:

1. Open NuGet Pakketbeheer door Tools>NuGet Pakketbeheer> Manage NuGet Packages for Solution te selecteren.
2. Selecteer Bladeren en voer vervolgens Azure.Communication.Calling.WindowsClient in het zoekvak in.
3. Zorg ervoor dat het selectievakje Voorlopige versie opnemen is ingeschakeld.
4. Selecteer het pakket Azure.Communication.Calling.WindowsClient en selecteer vervolgens Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 of een nieuwere versie.
5. Schakel het selectievakje in dat overeenkomt met het Azure Communication Services-project in het rechterdeelvenster.
6. Selecteer Installeren.

Methoden voor deelname aan vergadering

Als u wilt deelnemen aan een Teams-vergadering, gebruikt u de CallAgent.join methode en geeft u de toepassingscontext door, JoinMeetingLocatoren JoinCallOptions.

Vergaderings-id en wachtwoordcode

Hiermee TeamsMeetingIdLocator wordt een vergadering gevonden met behulp van een vergaderings-id en wachtwoordcode. Deze vindt u onder de deelnamegegevens van een Teams-vergadering. Een Teams-vergaderings-id is 12 tekens lang en bestaat uit numerieke cijfers gegroepeerd in drie tekens (dat wil 000 000 000 000bijvoorbeeld). Een wachtwoordcode bestaat uit 6 alfabettekens (dat wil aBcDeFbijvoorbeeld ). De wachtwoordcode is hoofdlettergevoelig.

String meetingId, passcode; 
TeamsMeetingIdLocator locator = new TeamsMeetingIdLocator(meetingId, passcode);

Koppeling naar vergadering

Er TeamsMeetingLinkLocator wordt een vergadering gevonden met behulp van een koppeling naar een Teams-vergadering. Dit vindt u onder de deelnamegegevens van een Teams-vergadering.

String meetingLink; 
TeamsMeetingLinkLocator locator = new TeamsMeetingLinkLocator(meetingLink);

Coördinaten van vergadering

Vergaderingen TeamsMeetingCoordinatesLocator worden gevonden met behulp van een organisator-id, tenant-id, thread-id en een bericht-id. Deze informatie vindt u met Behulp van Microsoft Graph.

Guid organizerId, tenantId;
String threadId, messageId;
TeamsMeetingCoordinatesLocator locator = new TeamsMeetingCoordinatesLocator(threadId, organizerId, tenantId, messageId);

Deelnemen aan een vergadering met locators

Nadat u deze Teams-vergaderingszoekers hebt gemaakt, kunt u deze gebruiken om deel te nemen aan een Teams-vergadering, CallAgent.join zoals hieronder wordt weergegeven.

JoinCallOptions options = new JoinCallOptions();
call = agent.join(
        getApplicationContext(),
        locator,
        options);

Uw systeem instellen

Volg deze stappen om uw systeem in te stellen.

Het Visual Studio-project maken

Voor een Universeel Windows-platform-app maakt u in Visual Studio 2022 een nieuw leeg app-project (Universal Windows). Nadat u de projectnaam hebt ingevoerd, kunt u een Windows SDK kiezen die hoger is dan 10.0.17763.0.

Maak voor een WinUI 3-app een nieuw project met de sjabloon Blank App, Packaged (WinUI 3 in Desktop) om een WinUI 3-app met één pagina in te stellen. Windows-app SDK versie 1.3 of hoger is vereist.

Installeer het pakket en afhankelijkheden met behulp van NuGet Pakketbeheer

De Aanroepende SDK-API's en -bibliotheken zijn openbaar beschikbaar via een NuGet-pakket.

Het NuGet-pakket voor aanroepende SDK zoeken, downloaden en installeren:

1. Open NuGet Pakketbeheer door Tools>NuGet Pakketbeheer> Manage NuGet Packages for Solution te selecteren.
2. Selecteer Bladeren en voer vervolgens Azure.Communication.Calling.WindowsClient in het zoekvak in.
3. Zorg ervoor dat het selectievakje Voorlopige versie opnemen is ingeschakeld.
4. Selecteer het pakket Azure.Communication.Calling.WindowsClient en selecteer vervolgens Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 of een nieuwere versie.
5. Schakel het selectievakje in dat overeenkomt met het Azure Communication Services-project in het rechterdeelvenster.
6. Selecteer Installeren.

Methoden voor deelname aan vergadering

Als u wilt deelnemen aan een Teams-vergadering, gebruikt u de CallAgent.join methode en geeft u een JoinMeetingLocator en een JoinCallOptions.

Vergaderings-id en wachtwoordcode

Hiermee TeamsMeetingIdLocator wordt een vergadering gevonden met behulp van een vergaderings-id en wachtwoordcode. Deze vindt u onder de deelnamegegevens van een Teams-vergadering. Een Teams-vergaderings-id is 12 tekens lang en bestaat uit numerieke cijfers gegroepeerd in drie tekens (dat wil 000 000 000 000bijvoorbeeld). Een wachtwoordcode bestaat uit 6 alfabettekens (dat wil aBcDeFbijvoorbeeld ). De wachtwoordcode is hoofdlettergevoelig.

String meetingId, passcode
let locator = TeamsMeetingIdLocator(meetingId: meetingId, passcode: passcode)

Koppeling naar vergadering

Er TeamsMeetingLinkLocator wordt een vergadering gevonden met behulp van een koppeling naar een Teams-vergadering. Dit vindt u onder de deelnamegegevens van een Teams-vergadering.

String meetingLink
let locator = TeamsMeetingLinkLocator(meetingLink: meetingLink)

Deelnemen aan een vergadering met locators

Nadat u deze Teams-vergaderingszoekers hebt gemaakt, kunt u deze gebruiken om deel te nemen aan een Teams-vergadering, CallAgent.join zoals hieronder wordt weergegeven.

func joinTeamsMeeting() {
    // Ask permissions
    AVAudioSession.sharedInstance().requestRecordPermission { (granted) in
        if granted {
            let joinCallOptions = JoinCallOptions()
            
            // Insert meeting locator code for specific join methods here

            // for CallAgent callAgent
            self.callAgent?.join(with: teamsMeetingLinkLocator, joinCallOptions: joinCallOptions) 
        }
    }
}

Uw systeem instellen

Volg deze stappen om uw systeem in te stellen.

Het Visual Studio-project maken

Voor een Universeel Windows-platform-app maakt u in Visual Studio 2022 een nieuw leeg app-project (Universal Windows). Nadat u de projectnaam hebt ingevoerd, kunt u een Windows SDK kiezen die hoger is dan 10.0.17763.0.

Maak voor een WinUI 3-app een nieuw project met de sjabloon Blank App, Packaged (WinUI 3 in Desktop) om een WinUI 3-app met één pagina in te stellen. Windows-app SDK versie 1.3 of hoger is vereist.

Installeer het pakket en afhankelijkheden met behulp van NuGet Pakketbeheer

De Aanroepende SDK-API's en -bibliotheken zijn openbaar beschikbaar via een NuGet-pakket.

Het NuGet-pakket voor aanroepende SDK zoeken, downloaden en installeren:

1. Open NuGet Pakketbeheer door Tools>NuGet Pakketbeheer> Manage NuGet Packages for Solution te selecteren.
2. Selecteer Bladeren en voer vervolgens Azure.Communication.Calling.WindowsClient in het zoekvak in.
3. Zorg ervoor dat het selectievakje Voorlopige versie opnemen is ingeschakeld.
4. Selecteer het pakket Azure.Communication.Calling.WindowsClient en selecteer vervolgens Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 of een nieuwere versie.
5. Schakel het selectievakje in dat overeenkomt met het Azure Communication Services-project in het rechterdeelvenster.
6. Selecteer Installeren.

Methoden voor deelname aan vergadering

Als u wilt deelnemen aan een Teams-vergadering, gebruikt u de CallAgent.JoinAsync methode en geeft u een JoinMeetingLocator en een JoinCallOptions.

Vergaderings-id en wachtwoordcode

Hiermee TeamsMeetingIdLocator wordt een vergadering gevonden met behulp van een vergaderings-id en wachtwoordcode. Deze vindt u onder de deelnamegegevens van een Teams-vergadering. Een Teams-vergaderings-id is 12 tekens lang en bestaat uit numerieke cijfers gegroepeerd in drie tekens (dat wil 000 000 000 000bijvoorbeeld). Een wachtwoordcode bestaat uit 6 alfabettekens (dat wil aBcDeFbijvoorbeeld ). De wachtwoordcode is hoofdlettergevoelig.

string meetingId, passcode; 
TeamsMeetingIdLocator locator = new TeamsMeetingIdLocator(meetingId, passcode);

Koppeling naar vergadering

Er TeamsMeetingLinkLocator wordt een vergadering gevonden met behulp van een koppeling naar een Teams-vergadering. Dit vindt u onder de deelnamegegevens van een Teams-vergadering.

string meetingLink; 
TeamsMeetingLinkLocator locator = new TeamsMeetingLinkLocator(meetingLink);

Coördinaten van vergadering

Vergaderingen TeamsMeetingCoordinatesLocator worden gevonden met behulp van een organisator-id, tenant-id, thread-id en een bericht-id. Deze informatie vindt u met Behulp van Microsoft Graph.

Guid organizerId, tenantId;
string threadId, messageId;
TeamsMeetingCoordinatesLocator locator = new TeamsMeetingCoordinatesLocator(threadId, organizerId, tenantId, messageId);

Deelnemen aan een vergadering met locators

Nadat u deze Teams-vergaderingszoekers hebt gemaakt, kunt u deze gebruiken om deel te nemen aan een Teams-vergadering, CallAgent.JoinAsync zoals hieronder wordt weergegeven.

var joinCallOptions = new JoinCallOptions() {
        OutgoingAudioOptions = new OutgoingAudioOptions() { IsMuted = true },
        OutgoingVideoOptions = new OutgoingVideoOptions() { Streams = new OutgoingVideoStream[] { cameraStream } }
    };
var call = await callAgent.JoinAsync(locator, joinCallOptions);

Volgende stappen

• Meer informatie over het beheren van gesprekken
• Meer informatie over het beheren van video
• Meer informatie over het doorschakelen van gesprekken