Sdílet prostřednictvím


Klientská knihovna azure Communication Call Automation pro Python – verze 1.1.0

Tento balíček obsahuje sadu Python SDK pro službu Azure Communication Call Automation. Automatizace volání poskytuje vývojářům možnost vytvářet inteligentní pracovní postupy volání založené na serveru a zaznamenávat hovory pro hlasové kanály a kanály veřejné telefonní sítě.

Přehled automatizace | voláníDokumentace k produktu

Právní omezení

Podpora balíčků Azure SDK Python pro Python 2.7 skončila 1. ledna 2022. Další informace a dotazy najdete na https://github.com/Azure/azure-sdk-for-python/issues/20691

Začínáme

Požadavky

  • K použití tohoto balíčku se vyžaduje Python 3.7 nebo novější.
  • K použití tohoto balíčku potřebujete předplatné Azure .
  • Nasazený prostředek komunikačních služeb K jeho nastavení můžete použít Azure Portal nebo Azure PowerShell.

Instalace

Nainstalujte sadu SDK pro automatizaci volání služby Azure Communication Service.

pip install azure-communication-callautomation

Klíčové koncepty

Název Description
CallAutomationClient CallAutomationClient je primární rozhraní pro vývojáře, kteří používají tuto klientskou knihovnu. Dá se použít k inicializaci volání pomocí createCall nebo answerCall. Dá se také použít k provádění akcí nahrávání, jako je startRecording
CallConnectionClient CallConnectionClient představuje probíhající hovor. Jakmile je volání navázáno pomocí createCall nebo answerCall, je možné pro volání provést další akce, například transfer nebo play_media.
Události zpětného volání Události zpětného volání jsou události odesílané zpět během volání. Poskytuje informace a stav volání, například CallConnected. CallbackUrl musí být zadané během createCall a a answerCallna tuto adresu URL se odesílají události zpětného volání.
Událost příchozího hovoru Když dojde k příchozímu hovoru (který lze přijmout pomocí answerCall), bude odeslána událost eventgrid příchozího volání. To se liší od výše uvedených událostí zpětného volání a mělo by být nastaveno na Azure Portal. Podrobnosti najdete v tématu Příchozí hovor .

Příklady

Inicializace CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

# Your unique Azure Communication service endpoint
endpoint_url = '<ENDPOINT>'
client = CallAutomationClient.from_connection_string(endpoint_url)

Vytvořit hovor

from azure.communication.callautomation import (
    CallAutomationClient,
    CommunicationUserIdentifier
)

# target endpoint for ACS User
user = CommunicationUserIdentifier("8:acs:...")

# callback url to receive callback events
callback_url = "https://<MY-EVENT-HANDLER-URL>/events"

# send out the invitation, creating call
result = client.create_call(user, callback_url)

# this id can be used to do further actions in the call
call_connection_id = result.call_connection_id

Přehrát multimédia

# using call connection id, get call connection
call_connection = client.get_call_connection(call_connection_id)

# from callconnection of result above, play media to all participants
my_file = FileSource(url="https://<FILE-SOURCE>/<SOME-FILE>.wav")
call_connection.play_media(my_file)

Řešení potíží

Další kroky

Zadání zpětné vazby

Pokud narazíte na nějaké chyby nebo máte návrhy, nahlaste problém v části Problémy projektu.

Přispívání

Tento projekt vítá příspěvky a návrhy. Většina příspěvků vyžaduje souhlas s licenční smlouvou s přispěvatelem (CLA), která stanoví, že máte právo udělit nám práva k používání vašeho příspěvku a skutečně tak činíte. Podrobnosti najdete tady: https://cla.microsoft.com

Při odesílání žádosti o přijetí změn robot CLA automaticky určí, jestli je potřeba poskytnout smlouvu CLA, a příslušným způsobem žádost o přijetí změn upraví (např. přidáním jmenovky nebo komentáře). Stačí postupovat podle pokynů robota. Pro všechna úložiště používající naši smlouvu CLA to stačí udělat jenom jednou.

Tento projekt přijal [Pravidla chování open source společnosti Microsoft][code_of_conduct]. Další informace najdete v nejčastějších dotazech k pravidlům chování. V případě jakýchkoli dotazů nebo připomínek kontaktujte opencode@microsoft.com.