Přehled sady SDK pro volání
Důležité
Do 31. Azure Communication Services 31. července 2021 upgradujte na sadu SDK volání služby 1.1.0 (nebo novější) pro JavaScript.
Rozhraní API protokolu SDP (Plan B Session Description Protocol) je zastaralé. Communication Services Do 31. července 2021 aktualizujte své 31. července 2021 své hovory na verzi 1.1.0 (nebo novější), abyste zabránili tomu, že toto vyněcování ovlivní vaše uživatele. Další informace najdete v poznámkách k verzi volající knihovny.
Volající sada SDK umožňuje zařízením koncových uživatelů, aby mohli využívat hlasové a obrazové komunikační prostředí. Tato stránka obsahuje podrobné popisy volání funkcí, včetně informací o podpoře platforem a prohlížečů. Chcete-li začít hned, podívejte se prosím na volání rychlý Start nebo volání Hero Sample.
Až začnete s vývojem, podívejte se na stránku známé problémy , kde najdete chyby, na kterých pracujeme.
Klíčové funkce pro volání sady SDK:
- Adresování – komunikační služby Azure poskytují obecné identity , které se používají k adresování koncových bodů komunikace. Klienti používají tyto identity k ověřování ve službě a vzájemně komunikují. Tyto identity se používají při volání rozhraní API, která klientům poskytují přehled o tom, kdo je připojen ke volání (soupisku).
- Šifrování – volající sada SDK šifruje provoz a zabraňuje manipulaci na síti.
- Správa zařízení a média – volání sady SDK poskytuje vybavení pro vytváření vazeb na zvukové a video zařízení, zakóduje obsah pro efektivní přenos prostřednictvím komunikačního plánu komunikací a vykresluje obsah do výstupních zařízení a zobrazení, která určíte. K dispozici jsou také rozhraní API pro sdílení obrazovky a aplikací.
- PSTN (PSTN ) – volání sady SDK může přijímat a iniciovat hlasové hovory s tradičním integrovaným systémem telefonního subsystému, který používá telefonní čísla, která získáte v Azure Portal nebo programově.
- Teams schůzky – volání sady SDK se může připojit k Teams schůzce a interagovat s Teamsmi grafickým plánem hlasu a videa.
- Oznámení – volání sady SDK poskytuje rozhraní API, která klientům umožňují upozorňování na příchozí volání. V situacích, kdy vaše aplikace není spuštěná v popředí, jsou k dispozici vzory pro příjem místních oznámení ("informační zprávy"), aby bylo možné koncovým uživatelům informovat o příchozím volání.
Podrobné možnosti
Následující seznam obsahuje sadu funkcí, které jsou aktuálně k dispozici ve komunikačních službách Azure, které volají sady SDK.
| Skupina funkcí | Schopnost | JS | Windows | Java (Android) | Objective-C (iOS) |
|---|---|---|---|---|---|
| Základní funkce | Jedno volání 1:1 mezi dva uživatele | ✔️ | ✔️ | ✔️ | ✔️ |
| Umístit skupinové volání s více než dvěma uživateli (až 350 uživatelů) | ✔️ | ✔️ | ✔️ | ✔️ | |
| Zvýšení úrovně volání 1:1 se dvěma uživateli na skupinové volání s více než dvěma uživateli | ✔️ | ✔️ | ✔️ | ✔️ | |
| Připojit se k volání skupiny po jeho spuštění | ✔️ | ✔️ | ✔️ | ✔️ | |
| Pozvat dalšího účastníka VoIP, aby se připojil k probíhajícímu volání skupiny | ✔️ | ✔️ | ✔️ | ✔️ | |
| Střední řízení volání | Zapnout/vypnout video | ✔️ | ✔️ | ✔️ | ✔️ |
| Ztlumení a ztlumení mikrofonu | ✔️ | ✔️ | ✔️ | ✔️ | |
| Přepínání mezi fotoaparáty | ✔️ | ✔️ | ✔️ | ✔️ | |
| Místní blokování/zrušení blokování | ✔️ | ✔️ | ✔️ | ✔️ | |
| Aktivní mluvčí | ✔️ | ✔️ | ✔️ | ✔️ | |
| Zvolit mluvčí pro volání | ✔️ | ✔️ | ✔️ | ✔️ | |
| Volba mikrofonu pro volání | ✔️ | ✔️ | ✔️ | ✔️ | |
| Zobrazit stav účastníka Nečinné, předčasné médium, připojení, připojení, blokováno, v předsálí, odpojeno |
✔️ | ✔️ | ✔️ | ✔️ | |
| Zobrazit stav volání Předčasné médium, příchozí, připojení, vyzvánění, připojení, blokování, odpojování, odpojení |
✔️ | ✔️ | ✔️ | ✔️ | |
| Show if a participant is muted | ✔️ | ✔️ | ✔️ | ✔️ | |
| Zobrazení důvodu, proč účastník opustil volání | ✔️ | ✔️ | ✔️ | ✔️ | |
| Sdílení obrazovky | Sdílení celé obrazovky z aplikace | ✔️ | ❌ | ❌ | ❌ |
| Sdílení konkrétní aplikace (ze seznamu spuštěných aplikací) | ✔️ | ❌ | ❌ | ❌ | |
| Sdílení karty webového prohlížeče ze seznamu otevřených karet | ✔️ | ❌ | ❌ | ❌ | |
| Účastník může zobrazit vzdálenou složku obrazovky | ✔️ | ✔️ | ✔️ | ✔️ | |
| Seznamu | Seznam účastníků | ✔️ | ✔️ | ✔️ | ✔️ |
| Odebrání účastníka | ✔️ | ✔️ | ✔️ | ✔️ | |
| PSTN | Volání 1:1 s účastníkem veřejné telefonní sítě | ✔️ | ✔️ | ✔️ | ✔️ |
| Volání skupiny s účastníky veřejné telefonní sítě | ✔️ | ✔️ | ✔️ | ✔️ | |
| Zvýšení 1:1 hovoru s účastníkem veřejné telefonní sítě do skupinového hovoru | ✔️ | ✔️ | ✔️ | ✔️ | |
| Telefonování ze skupinového hovoru jako účastník veřejné telefonní sítě | ✔️ | ✔️ | ✔️ | ✔️ | |
| Obecné | Testování mikrofonu, mluvčího a kamery pomocí služby testování zvuku (k dispozici voláním 8:echo123) | ✔️ | ✔️ | ✔️ | ✔️ |
| Správa zařízení | Požádat o oprávnění k používání zvuku nebo videa | ✔️ | ✔️ | ✔️ | ✔️ |
| Získání seznamu fotoaparátů | ✔️ | ✔️ | ✔️ | ✔️ | |
| Nastavení fotoaparátu | ✔️ | ✔️ | ✔️ | ✔️ | |
| Získání vybrané kamery | ✔️ | ✔️ | ✔️ | ✔️ | |
| Získání seznamu mikrofonů | ✔️ | ✔️ | ❌ | ❌ | |
| Nastavení mikrofonu | ✔️ | ✔️ | ❌ | ❌ | |
| Získání vybraného mikrofonu | ✔️ | ✔️ | ❌ | ❌ | |
| Získání seznamu mluvčích | ✔️ | ✔️ | ❌ | ❌ | |
| Nastavení mluvčího | ✔️ | ✔️ | ❌ | ❌ | |
| Získání vybraného mluvčího | ✔️ | ✔️ | ❌ | ❌ | |
| Vykreslování videa | Vykreslování jednoho videa na mnoha místech (místní fotoaparát nebo vzdálený datový proud) | ✔️ | ✔️ | ✔️ | ✔️ |
| Nastavit nebo aktualizovat režim škálování | ✔️ | ✔️ | ✔️ | ✔️ | |
| Vykreslit vzdálený video stream | ✔️ | ✔️ | ✔️ | ✔️ |
Volání podpory streamování SDK
Komunikační služby, které volají sadu SDK, podporují následující konfigurace streamování:
| Omezení | Web | Windows/Android/iOS |
|---|---|---|
| Maximální počet odchozích místních datových proudů, které se dají poslat současně | 1 sdílení obrazovky nebo 1 | 1 sdílení obrazovky a 1 video + 1 |
| Maximální počet příchozích vzdálených streamů, které se dají vykreslovat současně | 4 videa + 1 sdílení obrazovky | 6 videí + 1 sdílení obrazovky |
I když volající sada SDK neuplatňuje tato omezení, můžou uživatelé při překročení výkonu zaznamenat snížení výkonu.
Volání sady SDK časový limit
Následující časové limity se vztahují na sady SDK pro volání komunikačních služeb:
| Akce | Časový limit v sekundách |
|---|---|
| Znovu připojit/odebrat účastníka | 120 |
| Přidání nebo odebrání nové modální metody ze volání (spuštění/zastavení videa nebo sdílení obrazovky) | 40 |
| Časový limit operace přenosu volání | 60 |
| časový limit pro zahájení volání 1:1 | 85 |
| Časový limit pro vytvoření volání skupiny | 85 |
| Časový limit pro vytvoření volání veřejné telefonní sítě | 115 |
| Zvýšit úroveň volání 1:1 na časový limit volání skupiny | 115 |
JavaScript – volání sady SDK pomocí operačního systému a prohlížeče
Následující tabulka představuje sadu podporovaných prohlížečů, které jsou aktuálně k dispozici. Pokud není uvedeno jinak, podporujeme nejnovější tři verze prohlížeče .
| Platforma | Chrome | Safari | Edge (Chromium) |
|---|---|---|---|
| Android | ✔️ | ❌ | ❌ |
| iOS | ❌ | ✔️ | ❌ |
| macOS | ✔️ | ✔️ | ❌ |
| Windows | ✔️ | ❌ | ✔️ |
| Ubuntu/Linux | ✔️ | ❌ | ❌ |
- Sdílení odchozí obrazovky není podporováno v systému iOS nebo Android.
- aplikace pro iOS v Safari nemůže vytvořit výčet nebo vybrat zařízení s mikrofonem a mluvčím (například Bluetooth), jedná se o omezení operačního systému a vždy jenom jedno zařízení, řídí výchozí výběr zařízení v operačním systému.
Podpora sady SDK volání Androidu
Podpora rozhraní Android API úrovně 21 nebo vyšší
Podpora pro Java 7 nebo novější
Podpora pro Android Studio 2,0
Podpora pro volání sady SDK pro iOS
Podpora pro iOS 10.0 + v době sestavení a iOS 12.0 + v době běhu
Xcode 12.0 +
Volání modelu zabezpečení prohlížeče klienta
Uživatel WebRTC přes HTTPS
Rozhraní API WebRTC jako getUserMedia vyžadují, aby aplikace, která volá tato rozhraní API, byla obsluhována prostřednictvím protokolu HTTPS.
Pro místní vývoj můžete použít http://localhost .
Vložení komunikačních služeb pro volání sady SDK v prvku IFRAME
Nové zásady oprávnění (označované taky jako zásady funkcí) se přijímají různými prohlížeči. Tato zásada má vliv na volání scénářů tím, že řídí, jak můžou aplikace přistupovat ke kameře a mikrofonu zařízení prostřednictvím elementu IFRAME s více zdroji.
Pokud chcete použít prvek IFRAME k hostování části aplikace z jiné domény, je nutné přidat allow atribut se správnou hodnotou do prvku IFRAME.
Tento prvek IFRAME například umožňuje přístup ke kameře a mikrofonu:
<iframe allow="camera *; microphone *">
Další kroky
Další informace najdete v následujících článcích:
- Seznamte se s obecnými toky volání
- Další informace o typech volání
- Plánování řešení veřejné sítě