Delen via

Quickstart: Gebeurtenissen voor spraak- en videogesprekken verwerken

  • Artikel

Belangrijk

De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Ga aan de slag met Azure Communication Services met behulp van Azure Event Grid om spraak- en videogesprekken van Communication Services af te handelen.

Over Azure Event Grid

Azure Event Grid is een gebeurtenisservice in de cloud. In dit artikel leert u hoe u zich abonneert op gebeurtenissen voor Communication Service-gebeurtenissen en hoe u een gebeurtenis activeert om het resultaat weer te geven. Normaal gesproken verzendt u gebeurtenissen naar een eindpunt dat de gebeurtenisgegevens verwerkt en vervolgens in actie komt. In dit artikel sturen we de gebeurtenissen naar een web-app die de berichten verzamelt en weergeeft.

Vereisten

Instellen

Event Grid-resourceprovicer inschakelen

Als u Event Grid in uw Azure-abonnement nog niet eerder hebt gebruikt, moet u mogelijk de Event Grid-resourceprovider registreren in de onderstaande stappen:

In Azure Portal:

  1. Selecteer Abonnementen in het menu links.
  2. Selecteer het abonnement dat u voor Event Grid gebruikt.
  3. Selecteer onder Instellingen in het menu links de optie Resourceproviders.
  4. Zoek Microsoft.EventGrid.
  5. Als deze niet is geregistreerd, selecteert u Registreren.

Het kan even duren voordat de registratie is voltooid. Selecteer Vernieuwen om de status bij te werken. Wanneer de StatusGeregistreerde is, bent u klaar om verder te gaan.

Event Grid Viewer-implementatie

Voor deze quickstart gebruiken we het Azure Event Grid Viewer-voorbeeld om bijna in realtime gebeurtenissen te bekijken. Zo krijgt de gebruiker ervaring met een realtime feed. Bovendien moet de payload voor elke gebeurtenis ook beschikbaar zijn voor inspectie.

Abonneren op spraak- en videogesprekken met webhook

Navigeer in de portal naar de Azure Communication Services-resource die u hebt gemaakt. Selecteer in de Communication Service-resource Gebeurtenissen in het menu aan de linkerzijde van de pagina Communication Services.

Screenshot showing selecting the event subscription button within a resource's events page.

Druk op Gebeurtenisabonnement toevoegen om de wizard te openen.

Voer op de pagina Gebeurtenisabonnement maken een naam in voor het gebeurtenisabonnement.

U kunt zich abonneren op specifieke gebeurtenissen om Event Grid te laten weten op welke van de spraak- en video-gebeurtenissen waarop u zich wilt abonneren en waar de gebeurtenissen moeten worden verzonden. Selecteer de gebeurtenissen waarvoor u zich wilt abonneren in het vervolgkeuzemenu. Voor spraak- en videogesprekken hebt u de mogelijkheid om te kiezen Call Started, Call EndedCall Participant added en Call Participant Removed.

Als u wordt gevraagd om de naam van een Systeemonderwerp op te geven, kunt u een unieke tekenreeks opgeven. Dit veld heeft geen invloed op uw ervaring en wordt gebruikt voor interne telemetrie.

Bekijk de volledige lijst door Azure Communication Services ondersteunde gebeurtenissen.

Screenshot showing the calling event types being selected.

Selecteer Webhook voor het Eindpunttype.

Screenshot showing the Endpoint Type field being set to Web Hook.

Klik voor Eindpunt op Een eindpunt selecteren en voer de URL van uw web-app in.

In dit geval gebruiken we de URL van het Azure Event Grid Viewer-voorbeeld dat we eerder in deze quickstart hebben ingesteld. De URL voor het voorbeeld heeft de volgende indeling: https://{{site-name}}.azurewebsites.net/api/updates

Selecteer vervolgens Selectie bevestigen.

Screenshot showing confirming a Web Hook Endpoint.

Gebeurtenissen voor spraak- en videogesprekken bekijken

Gebeurtenissen voor spraak- en videogesprekken activeren

Als u gebeurtenistriggers wilt weergeven, moeten we eerst de gebeurtenissen genereren.

  • Call Started gebeurtenissen worden gegenereerd wanneer een Spraak- en videogesprek van Azure Communication Services wordt gestart. Als u deze gebeurtenis wilt activeren, start u een aanroep die is gekoppeld aan uw Communication Services-resource.
  • Call Ended gebeurtenissen worden gegenereerd wanneer een Spraak- en videogesprek van Azure Communication Services wordt beëindigd. Als u deze gebeurtenis wilt activeren, beëindigt u een aanroep die is gekoppeld aan uw Communication Services-resource.
  • Call Participant Added gebeurtenissen worden gegenereerd wanneer een deelnemer wordt toegevoegd aan een spraak- en videogesprek van Azure Communication Services. Als u deze gebeurtenis wilt activeren, voegt u een deelnemer toe aan een spraak- en videogesprek van Azure Communication Services dat is gekoppeld aan uw Communication Services-resource.
  • Call Participant Removed gebeurtenissen worden gegenereerd wanneer een deelnemer wordt verwijderd uit een spraak- en videogesprek van Azure Communication Services. Als u deze gebeurtenis wilt activeren, verwijdert u een deelnemer uit een spraak- en videogesprek van Azure Communication Services dat is gekoppeld aan uw Communication Services-resource.

Bekijk de volledige lijst door Azure Communication Services ondersteunde gebeurtenissen.

Gebeurtenissen voor spraak- en videogesprekken ontvangen

Zodra u een van de bovenstaande acties hebt voltooid, ziet u dat gebeurtenissen voor spraak- en videogesprekken naar uw eindpunt worden verzonden. Deze gebeurtenissen worden weergegeven in het Azure Event Grid Viewer-voorbeeld dat we in het begin hebben ingesteld. U kunt op het oogpictogram naast de gebeurtenis klikken om de hele payload te bekijken.

Meer informatie over de gebeurtenisschema's en andere gebeurtenisconcepten.

Resources opschonen

Als u een Communication Services-abonnement wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle bijbehorende resources verwijderd. Meer informatie over het opschonen van resources.

U wilt mogelijk ook: