Sdílet prostřednictvím


Principy chyb volání a podkódů

Volající sada SDK a odpovídající serverová infrastruktura používají sjednocenou architekturu k reprezentaci chyb. Pomocí kódů chyb, dílčích kódů a jejich odpovídajících kategorií výsledků můžete jako vývojář snadněji porozumět těmto chybám a najít vysvětlení, proč k nim došlo a jak je v budoucnu zmírnit. Podrobnosti o výsledcích chyb se dají zobrazit takto:

Kód jsou modelována jako 3 číslice celá čísla, která označují stav odpovědi klienta nebo serveru. Jsou seskupené do:

  • Úspěšné odpovědi (200–299)
  • Chyba klienta (400–499)
  • Chyba serveru (500–599)

Podkód je definován jako celé číslo, kde každé číslo označuje jedinečný důvod specifický pro skupinu scénářů nebo konkrétní výsledek scénáře.
Zpráva popisuje výsledek a poskytuje rady, jak zmírnit problém s problémem v případě selhání výsledku.
ResultCategory – označuje typ chyby. V závislosti na kontextu může být Successhodnota , ExpectedError, UnexpectedClientErrornebo UnexpectedServerError

Důležité

Funkce popsané v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Principy chyb volání a podkódů

Kódy chyb, podkódy a odpovídající kategorie výsledků pomáhají vývojářům identifikovat a diagnostikovat chyby. Tyto kódy chyb jsou zpřístupněny prostřednictvím call.callEndReason vlastnosti po ukončení volání.

Podrobnosti o kódu chyby zahrnují:

Kód – jedná se o 3místná celá čísla představující stav odpovědi klienta nebo serveru. Kategorie kódu:

  • Úspěšné odpovědi (200–299)
  • Chyba klienta (400–499)
  • Chyba serveru (500–599)
  • Globální chyba (600–699)

Podkód – definuje se jako celé číslo, kde každé číslo označuje jedinečný důvod specifický pro skupinu scénářů nebo konkrétní výsledek scénáře.

Zpráva – popisuje výsledek a poskytuje rady, jak zmírnit problém, pokud je výsledkem selhání.

ResultCategory – označuje typ chyby. V závislosti na kontextu může být Successhodnota , ExpectedError, UnexpectedClientError, nebo UnexpectedServerError.

Kódy chyb a podkódy klienta služby Azure Communication Services volající sdk

U chyb klienta, pokud je ExpectedErrorvlastnost resultCategories , chyba se očekává z pohledu sady SDK. K těmto chybám běžně dochází v selháních předpokladů, jako jsou nesprávné argumenty předané aplikací nebo když aktuální stav systému nepovoluje volání rozhraní API. Aplikace by měla zkontrolovat důvod chyby a logiku pro vyvolání rozhraní API.

Podkód Kód Zpráva Kategorie výsledků Rada
40101 408 Vytvoření callagentu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
40104 408 Vytvoření callagentu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
40114 408 Připojení k infrastruktuře služby Azure Communication Services se nezdařilo. Zkuste to znovu a zkontrolujte síťové požadavky prohlížeče. Pokud požadavky stále selhávají, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError Další informace najdete v požadavcích na síť.
40115 412 Nepodařilo se vytvořit CallAgent, nepodařilo se inicializovat připojení k infrastruktuře služby Azure Communication Services. Zkuste to znovu a zkontrolujte síťové požadavky prohlížeče. Pokud požadavky stále selhávají, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError Další informace najdete v požadavcích na síť.
40216 500 Vytvoření callagentu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
40228 409 Vytvoření CallAgent se nezdařilo, instance CallAgent přidružené k této identitě již existuje. Odstraňte existující callagent nebo vytvořte nový s jinou identitou. ExpectedError
40230 409 Nelze vytvořit TeamsCallAgent, instanci TeamsCallAgent přidruženou k této identitě již existuje. Před vytvořením nového objektu odstraňte existujícího agenta TeamsCallAgent. ExpectedError
40606 405 Zobrazení výčtu reproduktorů se nezdařilo. Není podporováno zobrazení výčtu nebo výběru reproduktorů v androidu Chrome, iOS Safari ani macOS Safari. ExpectedError Výčet a výběr mluvčího se nepodporuje v Android Chrome, iOS Safari ani macOS Safari. Operační systém automaticky vybere reproduktor (výstupní zařízení).

Přečtěte si další informace o správě zařízení a o tom, jak tyto problémy co nejlépe zmírnit.
40613 400 Nepodařilo se získat oprávnění k použití mikrofonu nebo kamery, bylo zamítnuto nebo selhalo. Ujistěte se, že chcete povolit oprávnění v prohlížeči a v nastavení operačního systému. ExpectedError Přečtěte si další informace o tom, jak nejlépe zpracovat oprávnění zařízení.
40614 500 Nepovedlo se požádat o oprávnění zařízení, ujistěte se, že se oprávnění povolí v nastavení prohlížeče a v nastavení operačního systému a zkuste to znovu. Pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError Přečtěte si další informace o tom, jak nejlépe zpracovat oprávnění zařízení.
41006 400 Příchozí hovor se nepovedlo přijmout, není ve stavu vyzvánění. Přihlaste se k odběru incomingCall události CallAgent a přijměte příchozí hovor. ExpectedError Informace o původní příčině problému najdete v následujících článcích.
- Přijetí příchozího hovoru
- Přihlášení k odběru událostí sady SDK
41007 400 Příchozí hovor se nepodařilo odmítnout, není ve stavu vyzvánění. Přihlaste se k odběru incomingCall události CallAgent a zamítněte příchozí hovor. ExpectedError Informace o původní příčině problému najdete v následujících článcích.
- Přijetí příchozího hovoru
- Přihlášení k odběru událostí sady SDK
41015 500 Ztlumení mikrofonu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
41016 400 Ztlumení mikrofonu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
41025 400 Spuštění videa se nezdařilo, instance LocalVideoStream je neplatná nebo prázdná. Předejte instanci LocalVideoStream. ExpectedError Ujistěte se, že objekt předaný ke spuštění videa je instance LocalVideoStream.
LocalVideoStream Vytvoření objektu VideoDeviceInfo nebo objektu MediaStream pomocí

Pokud chcete zjistit původní příčinu problému, projděte si následující články:
- Volání pomocí videokamery
- Spuštění a zastavení odesílání místního videa během hovoru
- Nezpracované video v Accessu
41027 400 Nepovedlo se spustit video, video už je spuštěné. ExpectedError Užitečné odkazy:
- Volání pomocí videokamery
- Spuštění a zastavení odesílání místního videa během hovoru
41030 400 Video se nepovedlo zastavit, video je už zastavené. ExpectedError Užitečné odkazy:
- Volání pomocí videokamery
- Spuštění a zastavení odesílání místního videa během hovoru
41032 400 Nepodařilo se zastavit video, neplatný argument. LocalVideoStream použitý jako vstup se aktuálně neodesílají. ExpectedError LocalVideoStream, který se odesílá ve volání, je uložen v poli Call.localVideoStreams[] a je typu Video nebo RawMedia.
Pokud chcete zjistit původní příčinu problému, projděte si následující články:
- Volání pomocí videokamery
- Spuštění a zastavení odesílání místního videa během hovoru
- Nezpracované video v Accessu
41033 500 Volání se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
41034 500 Volání se nepovedlo obnovit. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. UnexpectedClientError
41035 400 Sdílení obrazovky se nepovedlo spustit, sdílení obrazovky je už spuštěné. ExpectedError Další informace o tom, jak spustit a zastavit sdílení obrazovky během hovoru
41041 400 Sdílení obrazovky se nepovedlo zastavit, sdílení obrazovky je už zastavené. ExpectedError Další informace o tom, jak spustit a zastavit sdílení obrazovky během hovoru
41048 410 Během procesu nastavení hovoru se nepovedlo spustit video. Ujistěte se, že chcete povolit oprávnění k videu v nastavení prohlížeče a v nastavení operačního systému a ujistěte se, že zařízení fotoaparátu nepoužívá jiný proces. UnexpectedClientError - Zařízení fotoaparátu může být v systému zakázané.
- Kameru používá jiný proces.
41056 412 Nepodařilo se zahájit hovor nebo se připojit k hovoru, pro tento prostředek služby Azure Communication Services není povolená zásada hlasu Teams Enterprise. Postupujte podle kurzu online a povolte ho. ExpectedError Přečtěte si, jak uživatelům povolit online a Telefonní systém Hlasovou schránku pro Teams Enterprise
41071 412 Nepovedlo se spustit sdílení obrazovky, hovor není ve stavu Připojeno. Přihlaste se k odběru události volání statteChanged , abyste věděli, kdy je hovor připojený. ExpectedError Užitečné odkazy:
- Kontrola vlastností volání
- Přihlášení k odběru událostí sady SDK
41073 412 Nepovedlo se získat nebo nastavit vlastní MediaStream. Tato funkce je aktuálně zakázaná službou Azure Communication Services. ExpectedError
43000 412 Nepovedlo se spustit video, videoza zařízení používá jiný proces nebo aplikace. Zastavte, aby se vaše kamera používala v jiném procesu nebo aplikaci, a zkuste to znovu. ExpectedError Přečtěte si další informace o tom, jak nejlépe řešit kameru používanou jiným procesem.
43001 403 Nepovedlo se spustit video, oprávnění nebyla udělena k používání vybraného videoza zařízení. Ujistěte se, že jsou v nastavení prohlížeče a v nastavení systému povolená oprávnění videoza zařízení. ExpectedError Ujistěte se, že oprávnění fotoaparátu jsou povolená v nastavení prohlížeče a v nastavení systému zařízení.
Ujistěte se, že kamery nejsou v nastavení systému zařízení zakázané.
V systému macOS se ujistěte, že je záznam obrazovky povolený z nastavení systému.

Užitečné odkazy:
- Vyžádání oprávnění zařízení-
Oprávnění ke sdílení obrazovky v systému macOS
- Vytvoření výčtu nebo přístupu k zařízením pro Safari v macOS a iOS
43002 500 Nepovedlo se spustit video, neznámou chybu. Zkuste to ještě jednou. Pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError
43004 400 Nepodařilo se přepnout videozaloha, neplatný vstup. Vstup musí být typu VideoDeviceInfo. ExpectedError Pomocí správce zařízení získejte seznam objektů VideoDeviceInfo a pak pomocí objektu VideoDeviceInfo přepněte zdroj.

Další informace o tom, jak spustit a zastavit odesílání místního videa během hovoru
43005 400 Nepodařilo se přepnout videoza zařízení, nejde přepnout na stejné videoza zařízení, které je už vybrané. ExpectedError
43013 412 Nepovedlo se spustit video, nenašla se žádná videoza zařízení. Ujistěte se, že jsou videoza zařízení připojená a povolená v nastavení systému. ExpectedError Ujistěte se, že máte na zařízení připojenou a nainstalovanou kameru.
43014 412 Nepodařilo se spustit video, chyba s žádostí o datový proud médií. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError
43015 412 Spuštění videa se nezdařilo, vypršel časový limit požadavku na datový proud médií. Povolte oprávnění na příkazovém řádku prohlížeče pro přístup k fotoaparátu a zkuste to znovu. ExpectedError K této chybě může dojít v případě, že uživatel neprovádí akci na výzvě k povolení přístupu k fotoaparátu v prohlížeči.
43016 412 Spuštění videa, oprávnění odepřená systémem se nezdařila. Ujistěte se, že jsou v nastavení prohlížeče a v nastavení systému povolená oprávnění videoza zařízení. ExpectedError – Ujistěte se, že oprávnění fotoaparátu jsou povolená v nastavení prohlížeče a v nastavení systému zařízení.
– Zajistěte, aby kamery nejsou v nastavení systému zařízení zakázané.
– V systému macOS se ujistěte, že je záznam obrazovky povolený z nastavení systému.

Užitečné odkazy:
- Vyžádání oprávnění zařízení
-Oprávnění ke sdílení obrazovky v systému macOS
- Vytvoření výčtu nebo přístupu k zařízením pro Safari v macOS a iOS
43017 412 Spuštění videa, nepodporovaného streamu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError
43018 412 Nepovedlo se spustit video, nepodařilo se nastavit omezení. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError Další informace o nastavení omezení videa
43019 412 Nepovedlo se spustit video, žádné zařízení není vybrané. Ujistěte se, že chcete předat LocalVideoStream vytvořený pomocí VideoDeviceInfo a zkuste to znovu. Pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError Užitečné odkazy:
- Volání pomocí videokamery
- Spuštění a zastavení odesílání místního videa během hovoru
43200 412 Nepodařilo se vykreslit stream videa, tento stream není k dispozici. Přihlaste se k odběru vlastnosti isAvailable datového proudu, abyste dostávali oznámení, když má vzdálený účastník video zapnuté a stream je k dispozici pro vykreslování. ExpectedError Užitečné odkazy:
- Vykreslení videa nebo sdílení obrazovek vzdáleného účastníka
- Přidání videohovorů 1:1 do aplikace
- Přihlášení k odběru událostí sady SDK
43202 404 Stream videa se nepovedlo vykreslit, tento stream už není dostupný. Vzdálený účastník vypnul své video. ExpectedError Vzdálený účastník vypnul své video při pokusu o vytvoření zobrazení.
43203 408 Při čekání na snímky videa se nepodařilo vykreslit datový proud videa, vypršel časový limit vykreslování. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError
43204 500 Nepodařilo se vykreslit stream videa, nepodařilo se přihlásit k odběru videa v infrastruktuře služby Azure Communication Services. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. UnexpectedClientError
43209 405 Nepodařilo se vykreslit video stream, VideoStreamRenderer byl uvolněn během procesu inicializace. ExpectedError
43210 400 Nepovedlo se likvidovat VideoStreamRenderer, protože už je uvolněný. ExpectedError
43220 400 Vytvoření zobrazení se nezdařilo, maximální počet aktivních RemoteVideoStream zobrazení, která už byla dosažena. Pokud chcete vytvořit nový, můžete zlikvidovat předchozí. ExpectedError Přečtěte si další informace o tom, jak správně podporovat nejlepší počet příchozích streamů videa.
480 Koncový bod vzdáleného klienta není zaregistrovaný. Ujistěte se, že je vzdálený koncový bod dostupný.
481 Zpracování příchozího hovoru se nezdařilo. Vytvořte žádost o podporu prostřednictvím webu Azure Portal.
487 Volání se zrušilo, místně odmítlo, skončilo kvůli problému s neshodou koncových bodů nebo se nepodařilo vygenerovat nabídku médií. Očekávané chování
490, 491, 496, 497, 498 Problémy se sítí místního koncového bodu Zkontrolujte síť.
503, 504 Chyba infrastruktury komunikačních služeb Vytvořte žádost o podporu prostřednictvím webu Azure Portal.
600 Zaneprázdněn všude. Účastník se úspěšně kontaktoval, ale vrátil zaneprázdněný signál. Očekávané chování
603 Volání globálně odmítnuto účastníkem vzdálené komunikační služby. Očekávané chování
604 Neexistuje nikde. Požadovaný identifikátor URI neexistuje. Očekávané chování
606 Není přijatelné. Účastník se úspěšně kontaktoval, ale nemůže podporovat popsanou relaci. Očekávané chování

Principy chyb volání a podkódů

Kódy chyb, podkódy a odpovídající kategorie výsledků pomáhají vývojářům identifikovat a diagnostikovat chyby. Tyto kódy chyb jsou zpřístupněny prostřednictvím call.callEndReason vlastnosti po ukončení volání.

Podrobnosti o kódu chyby zahrnují:

Kód – jedná se o 3místná celá čísla představující stav odpovědi klienta nebo serveru. Kategorie kódu:

  • Úspěšné odpovědi (200–299)
  • Chyba klienta (400–499)
  • Chyba serveru (500–599)
  • Globální chyba (600–699)

Podkód – definuje se jako celé číslo, kde každé číslo označuje jedinečný důvod specifický pro skupinu scénářů nebo konkrétní výsledek scénáře.

Zpráva – popisuje výsledek a poskytuje rady, jak zmírnit problém, pokud je výsledkem selhání.

ResultCategory – označuje typ chyby. V závislosti na kontextu může být Successhodnota , ExpectedError, UnexpectedClientError, nebo UnexpectedServerError.

Volání kódů koncových volání a podkódů

Existují různá vysvětlení, proč hovor skončil. Tady jsou významy kódů volání a dílčích kódů, které ukazují, jak může volání končit.

Podkód Kód Zpráva Kategorie výsledků Rada
0 0 Hovor byl úspěšně ukončen místním účastníkem. Success
0 487 Hovor byl úspěšně ukončen, protože volající hovor zrušil. Success
0 603 Hovor byl úspěšně ukončen, protože byl odmítnut z volaný. Success
3100 410 Instalace volání selhala kvůli neočekávanému problému se sítí v klientovi, zkontrolujte síť klienta a zkuste to znovu. UnxpectedClientError – Ujistěte se, že používáte nejnovější sadu SDK v podporovaném prostředí.
3101 410 Volání se přeruší kvůli neočekávanému problému se sítí v klientovi, zkontrolujte síť klienta a zkuste to znovu. UnxpectedClientError
3112 410 Instalace volání selhala kvůli problému s konfigurací sítě na straně klienta, zkontrolujte konfiguraci sítě klienta a zkuste to znovu. ExpectedError
4097 0 Hovor skončil pro všechny uživatele organizátorem schůzky. Success
4507 495 Volání skončilo, protože aplikace neposkytla platný token služby Azure Communication Services. UnexpectedClientError Ujistěte se, že vaše aplikace implementuje mechanismus aktualizace tokenů správně.
4521 0 Hovor skončil, protože uživatel se náhle odpojil od hovoru. Příčinou může být to, že uživatel zavře aplikaci, která hostovala volání, například uživatel ukončil aplikaci zavřením karty prohlížeče bez správného zablokování. ExpectedError
5000 0 Hovor pro tohoto účastníka skončil. Účastník byl odebrán z konverzace jiným účastníkem. Success
5003 0 Volání bylo úspěšně ukončeno, protože všechny volané koncové body odmítly volání. Success
5300 0 Hovor pro tohoto účastníka skončil. Účastník byl odebrán z konverzace jiným účastníkem. Success
5317 0 Cílový účastník se odebere kvůli aktualizaci role účastníka. ExpectedError
5828 403 Připojení není pro schůzku místností autorizované, protože uživatel není součástí seznamu pozvaných osob. UnexpectedClientError
5829 403 Připojení není povoleno pro schůzku Místnosti za koncovým časem nebo před začátkem schůzky. UnexpectedClientError
5830 403 Ke schůzce místností se může připojit jenom uživatel komunikačních služeb. ExpectedError
7000 0 Volání skončilo platformou Azure Communication Services. Success
10003 487 Volání bylo přijato jinde jiným koncovým bodem tohoto uživatele. Success
10004 487 Volání bylo zrušeno při vypršení časového limitu, žádný volaný koncový bod byl přijat včas. Ujistěte se, že se uživateli zobrazilo oznámení, a zkuste ho znovu zahájit. ExpectedError
10024 487 Hovor byl úspěšně ukončen. Hovor odmítnutý všemi volanými koncovými body Success - Zkuste hovor umístit znovu.
10057 408 Volání selhalo, volané se nepodařilo dokončit nastavení volání, s největší pravděpodobností volanou ztracenou síť nebo aplikaci náhle ukončila. Ujistěte se, že jsou klienti připojení a jsou k dispozici. ExpectedError
301005 410 Účastník se odebral z hovoru infrastrukturou služby Azure Communication Services kvůli ztrátě připojení k médiím se stejnou infrastrukturou. K tomu obvykle dochází v případě, že účastník opustí hovor náhle nebo ztratí síťové připojení. Pokud chce účastník pokračovat v hovoru, může se znovu připojit. UnexpectedClientError Ujistěte se, že používáte nejnovější sadu SDK v podporovaném prostředí.
510403 403 Hovor skončil, dříve označený jako spam a teď je zablokovaný. ExpectedError – Ujistěte se, že je token komunikační služby platný a nevypršela jeho platnost.
- Ujistěte se, že chcete předávat AlternateId možnosti volání.
540487 487 Hovor byl úspěšně ukončen, protože volající hovor zrušil. Success
560000 0 Hovor byl úspěšně ukončen vzdáleným účastníkem veřejné telefonní sítě. Success Možné příčiny:
- Uživatel hovor ukončil.
- Hovor skončil mediálním agentem.
560486 486 Hovor skončil, protože vzdálený účastník veřejné telefonní sítě byl zaneprázdněn. Volaná čísla už byla v hovoru nebo má technické problémy.
404 Volání nebylo nalezeno. Ujistěte se, že číslo, které voláte (nebo hovor, ke kterému se připojujete), existuje.
408 Vypršel časový limit ovladače hovoru. Vypršel časový limit kontroleru volání čekající na zprávy protokolu z koncových bodů uživatele. Ujistěte se, že jsou klienti připojení a jsou k dispozici.
410 Chyba místní zásobníku médií nebo infrastruktury médií Ujistěte se, že používáte nejnovější sadu SDK v podporovaném prostředí.
430 Zprávu nelze doručit klientské aplikaci. Ujistěte se, že je klientská aplikace spuštěná a dostupná.
480 Koncový bod vzdáleného klienta není zaregistrovaný. Ujistěte se, že je vzdálený koncový bod dostupný.
481 Zpracování příchozího hovoru se nezdařilo. Vytvořte žádost o podporu prostřednictvím webu Azure Portal.
490, 491, 496, 497, 498 Problémy se sítí místního koncového bodu Zkontrolujte síť.
500, 503, 504 Chyba infrastruktury komunikačních služeb Vytvořte žádost o podporu prostřednictvím webu Azure Portal.