Vývoj pomocí rozhraní API služby Media Services v3

logo Media Services verze 3

hledáte dokumentaci k Media Services v2?

Jako vývojář můžete používat klientské knihovny pro (.NET, Python, Node.js, Java, Go a Ruby), které umožňují interakci s REST API pro snadné vytváření, správu a údržbu vlastních pracovních postupů pro média. Rozhraní API Media Services v3 je založené na specifikaci OpenAPI (dříve označované jako Swagger).

Tento článek popisuje pravidla, která se vztahují na entity a rozhraní API při vývoji s Media Services v3.

Upozornění

nedoporučuje se zabalit REST API pro Media Services přímo do vlastního kódu knihovny, jak to tak bude mít za následek to, že by to pro produkční účely vyžadovalo implementaci úplné logiky opakování správy prostředků azure a pochopte, jak spravovat dlouhodobě běžící operace v rozhraních api pro správu prostředků azure. To zpracovává klientské sady SDK pro různé jazyky – .NET, Java, TypeScript, Python, Ruby atd. – pro vás automaticky a omezení pravděpodobnosti potíží s rety logikou nebo neúspěšnými voláními rozhraní API. Klientské sady SDK to zvládnou už za vás. Kolekce post je poskytována více jako učebnní nástroj a ukazuje, co se ve skutečnosti klientské sady SDK skutečně dělají při vývoji s různými klientskými SDK.

Přístup k rozhraní API služby Azure Media Services

Abyste mohli získat autorizaci pro přístup k prostředkům a rozhraní API služby Media Services, musíte se nejprve ověřit. Služba Media Services podporuje ověřování na základě Azure Active Directory (Azure AD). K dispozici jsou dvě běžné možnosti ověřování:

  • Ověřování instančních objektů: Slouží k ověřování služeb (například webových aplikací, aplikací funkcí, aplikací logiky, rozhraní API nebo mikroslužeb). Mezi aplikace, které běžně využívají tuto metodu ověřování, patří aplikace spouštějící služby démonů, služby střední úrovně nebo naplánované úlohy. Například pro webové aplikace by vždy měla být střední vrstva, která se připojuje k Media Services pomocí objektu služby.
  • Ověřování uživatelů: Slouží k ověřování lidí, kteří pomocí aplikace pracují s prostředky služby Media Services. Interaktivní aplikace by nejprve měla uživatele vyzvat k zadání přihlašovacích údajů. Příkladem je aplikace konzoly pro správu, kterou autorizovaní uživatelé používají k monitorování úloh kódování nebo živého streamování.

Rozhraní API služby Media Services vyžaduje, aby uživatel nebo aplikace provádějící požadavky rozhraní REST API měli přístup k prostředku účtu služby Media Services a používali roli Přispěvatel nebo Vlastník. K rozhraní API je možné získat přístup také s rolí Čtenář, ale v takovém případě budou k dispozici pouze operace Get a List.Další informace najdete v tématu Řízení přístupu na základě role v Azure (Azure RBAC) Media Services účty.

Místo vytváření instančního objektu zvažte přístup k rozhraní API služby Media Services prostřednictvím Azure Resource Manageru s využitím spravovaných identit pro prostředky Azure. Další informace o spravovaných identitách pro prostředky Azure najdete v tématu Co jsou spravované identity pro prostředky Azure.

Objekt služby Azure AD

Aplikace Azure AD a instanční objekt by měly být ve stejném tenantovi. Po vytvoření aplikace udejte roli Přispěvatel nebo Vlastník aplikace přístup k Media Services účtu.

Pokud si nejste jistí, jestli máte oprávnění k vytvoření aplikace Azure AD, podívejte se na stránku Požadovaná oprávnění.

Na následujícím obrázku čísla představují tok požadavků v chronologickém pořadí:

Ověřování aplikace střední vrstvy pomocí AAD z webového rozhraní API

  1. Aplikace střední vrstvy si vyžádá přístupový token Azure AD, který má následující parametry:

    • Koncový bod tenanta Azure AD.
    • Media Services identifikátor URI prostředku.
    • Identifikátor URI prostředku pro rest Media Services.
    • Hodnoty aplikace Azure AD: ID klienta a tajný kód klienta.

    Pokud chcete získat všechny potřebné hodnoty, podívejte se na stránku Access Azure Media Services API.

  2. Přístupový token Azure AD se odesílá do střední vrstvy.

  3. Střední vrstva odešle požadavek do služby Azure Media REST API tokenem Azure AD.

  4. Střední vrstva získává zpět data z Media Services.

ukázky

Projděte si následující ukázky, které ukazují, jak se připojit pomocí objektu služby Azure AD:

Zásady vytváření názvů

Na názvy prostředků služby Azure Media Services v3 (například prostředky, úlohy, transformace) se vztahují omezení vytváření názvů Azure Resource Manageru. V souladu s Azure Resource Managerem jsou názvy prostředků vždy jedinečné. Jako názvy prostředků tedy můžete použít jakékoli řetězce jedinečného identifikátoru (například identifikátory GUID).

Media Services prostředků nelze zahrnout: "<", ">", "%", "&", ":", "\", "?", "/", "*", "+", ".", znak jednoduché uvozovky nebo jakékoli řídicí znaky. Všechny ostatní znaky jsou povolené. Maximální délka názvu prostředku je 260 znaků.

Další informace o vytváření názvů Azure Resource Manager najdete v tématu Požadavky na pojmenování a Zásady vytváření názvů.

Názvy souborů nebo objektů blob v rámci assetu

Názvy souborů nebo objektů blob v rámci assetu musí splňovat požadavky na název objektu blob i požadavky na název NTFS. Důvodem pro tyto požadavky jsou soubory, které je možné zkopírovat z úložiště objektů blob na místní disk NTFS ke zpracování.

Dlouhotr běžící operace

Operace označené v x-ms-long-running-operation souboru Azure Media Services jsou dlouhotrvalé operace.

Podrobnosti o tom, jak sledovat asynchronní operace Azure, najdete v tématu Asynchronní operace.

Media Services má následující dlouho běžící operace:

Po úspěšném odeslání dlouhé operace se zobrazí zpráva 201 Created (Vytvořeno 201) a musíte se dotazovat na dokončení operace s použitím ID vrácené operace.

Článek o sledování asynchronních operací Azure podrobně vysvětluje, jak sledovat stav asynchronních operací Azure prostřednictvím hodnot vrácených v odpovědi.

Pro danou živou událost nebo kterýkoli z přidružených živých výstupů se podporuje pouze jedna dlouhotringová operace. Po spuštění se dlouhotrvací operace musí dokončit před spuštěním následné dlouhotrvací operace ve stejné události LiveEvent nebo jakýchkoli přidružených živých výstupech. U živých událostí s více živými výstupy musíte před aktivací dlouhotrající operace na jiném živém výstupu počkat na dokončení dlouhotrající operace v jednom živém výstupu.

Sady SDK

Poznámka

U Azure Media Services sdk v3 není zaručeno, že budou bezpečné pro přístup z více vláken. Při vývoji vícevřetěové aplikace byste měli přidat vlastní logiku synchronizace vláken pro ochranu klienta nebo pro jedno vlákno použít nový objekt AzureMediaServicesClient. Také byste měli být opatrní při problémech s více vlákny, které zavádí volitelné objekty poskytnuté kódem klientovi (například instance HttpClient v .NET).

Sada SDK Reference
.NET SDK Referenční informace k .NET
Java SDK Referenční informace k Javě
Python SDK Referenční informace k Pythonu
Node.js SDK Referenční informace k Node.js
Go SDK Referenční informace k jazyku Go
Ruby SDK

Viz také

Průzkumník Azure Media Services

Azure Media Services Explorer (AMSE) je nástroj dostupný pro Windows, kteří chtějí získat informace o Media Services. AMSE je aplikace Winforms/C#, která nahrává, stahuje, kóduje, streamuje videa a živý obsah pomocí Media Services. Nástroj AMSE je pro klienty, kteří chtějí testovat Media Services bez psaní kódu. Kód AMSE je k dispozici jako prostředek pro zákazníky, kteří chtějí vyvíjet s Media Services.

AMSE je open source projekt, podporu poskytuje komunita (problémy je možné nahlásit na https://github.com/Azure/Azure-Media-Services-Explorer/issues) . Tento projekt přijal pravidla chování pro Microsoft Open Source. Další informace najdete v nejčastějších dotazech k etickým kodexům. S dalšími dotazy nebo připomínkami se obraťte opencode@microsoft.com na .

Filtrování, řazení, stránkování Media Services entit

Viz Filtrování, řazení a stránkování Azure Media Services entit.

Poklást otázky, poskytnout zpětnou vazbu a získat aktualizace

Podívejte se na článek Azure Media Services komunity, kde najdete různé způsoby, jak klást otázky, poskytnout zpětnou vazbu a získat aktuální informace o Media Services.

Viz také

Pokud chcete získat všechny potřebné hodnoty, podívejte se na stránku Access Azure Media Services API.

Další kroky