Fejlesztés a Media Services v3 API-kkal

  • Cikk

Media Services embléma v3

Figyelmeztetés

Az Azure Media Services 2024. június 30-án megszűnik. További információkért lásd az AMS kivezetési útmutatóját.

Fejlesztőként használhat ügyfélkódtárakat (.NET, Python, Node.js, Java és Go), amelyekkel a REST API-val egyszerűen hozhat létre, kezelhet és tarthat karban egyéni média-munkafolyamatokat. A Media Services v3 API az OpenAPI specifikáción alapul (korábbi nevén Swagger).

Ez a cikk az entitásokra és API-kra vonatkozó szabályokat ismerteti, amikor a Media Services v3 használatával fejleszt.

Figyelmeztetés

Nem ajánlott közvetlenül a saját kódtárkódjába burkolni a Media Services REST API-ját, mivel az éles környezetben való megfelelő működéshez implementálnia kell a teljes Azure Resource Management újrapróbálkozási logikát, és meg kell értenie, hogyan kezelheti a hosszú ideig futó műveleteket az Azure Resource Management API-kban. Ezt az ügyféloldali SDK-k kezelik különböző nyelvekhez – .NET, Java, TypeScript, Python stb. – automatikusan, és csökkenti az újrapróbálkozással vagy a sikertelen API-hívásokkal kapcsolatos problémák esélyét. Ezt már az ügyféloldali SDK-k kezelik.

Az Azure Media Services API elérése

A Media Services-erőforrások és a Media Services API eléréséhez először hitelesítenie kell magát. A Media Services az Azure Active Directory- (Azure AD-) alapú hitelesítést támogatja. Két gyakran használt hitelesítési lehetőség:

  • Szolgáltatásnév-hitelesítés: Szolgáltatások (például: webalkalmazások, függvényalkalmazások, logikai alkalmazások, API-k és mikroszolgáltatások) hitelesítésére szolgál. Ezt a hitelesítési módszert általában a démonszolgáltatásokat, közepes szintű szolgáltatásokat vagy ütemezett feladatokat futtató alkalmazások használják. Webalkalmazások esetében például mindig lennie kell egy olyan középső rétegnek, amely szolgáltatásnévvel csatlakozik a Media Serviceshez.
  • Felhasználóhitelesítés: Olyan személyek hitelesítésére szolgál, akik a Media Services-erőforrásokkal való interakcióhoz használják az alkalmazást. Az interaktív alkalmazásnak először fel kell kérnie a felhasználót a hitelesítési adatainak a megadására. Ilyen alkalmazás lehet például egy olyan felügyeletikonzol-alkalmazás, amelyet a jogosultsággal rendelkező felhasználók a kódolási feladatok és az élő streamelés monitorozására használnak.

A Media Services API megköveteli, hogy a REST API-kéréseket kezdeményező felhasználó vagy alkalmazás hozzáféréssel rendelkezzen a Media Services-fiókerőforráshoz, és Közreműködő vagy Tulajdonos szerepkört használjon. Az API az Olvasó szerepkörrel érhető el, de csak a Get vagy a List művelet lesz elérhető. További információ: Azure szerepköralapú hozzáférés-vezérlés (Azure RBAC) a Media Services-fiókokhoz.

Szolgáltatásnév létrehozása helyett érdemes lehet az Azure-erőforrások felügyelt identitásait használni a Media Services API Azure Resource Managerrel történő eléréséhez. Az Azure-erőforrások felügyelt identitásairól az Azure-erőforrások felügyelt identitásait ismertető cikkben tájékozódhat bővebben.

Azure AD szolgáltatásnév

A Azure AD alkalmazásnak és szolgáltatásnévnek ugyanabban a bérlőben kell lennie. Az alkalmazás létrehozása után adjon hozzáférést az alkalmazás közreműködői vagy tulajdonosi szerepkörének a Media Services-fiókhoz.

Ha nem biztos abban, hogy rendelkezik-e engedélyekkel egy Azure AD alkalmazás létrehozásához, olvassa el a Szükséges engedélyek című témakört.

Az alábbi ábrán a számok a kérések áramlását ábrázolják időrendi sorrendben:

Középső szintű alkalmazáshitelesítés webes API-ból származó AAD-vel

  1. A középső rétegbeli alkalmazások egy Azure AD hozzáférési jogkivonatot kérnek, amely a következő paraméterekkel rendelkezik:

    • Azure AD bérlői végpont.
    • Media Services-erőforrás URI-ja.
    • A REST Media Services erőforrás-URI-ja.
    • Azure AD alkalmazásértékek: az ügyfél-azonosító és az ügyfélkulcs.

    Az összes szükséges érték lekéréséhez lásd: Access Azure Media Services API.

  2. A Azure AD hozzáférési jogkivonatot a rendszer a középső szintre küldi.

  3. A középső réteg kérést küld az Azure Media REST API-nak a Azure AD jogkivonattal.

  4. A középső réteg visszaszerzi az adatokat a Media Servicesből.

Példák

Tekintse meg az alábbi mintákat, amelyek bemutatják, hogyan csatlakozhat Azure AD szolgáltatásnévhez:

Elnevezési konvenciók

Az Azure Media Services v3 erőforrásneveire is (pl. Adategység, Feladatok, Átalakítások) az Azure Resource Manager elnevezési korlátozásai vonatkoznak. Az Azure Resource Manager szolgáltatásnak megfelelően az erőforrásnevek mindig egyediek. Így bármilyen egyedi azonosító sztringet (pl. GUID-ok) használhat erőforrásnévként.

A Media Services-erőforrásnevek nem tartalmazhatják a következőket: ''<, '', '>%', '&', ':', '\', '?', '/', '*', '+', '.', az egyszeres idézőjel karakter vagy bármilyen vezérlőkarakterek. Minden egyéb karakter engedélyezett. Az erőforrásnév maximális hossza 260 karakter.

További információ az Azure Resource Manager elnevezéséről: Elnevezési követelmények és elnevezési konvenciók.

Egy objektumon belüli fájlok/blobok neve

Az objektumon belüli fájlok/blobok nevének meg kell felelnie a blobnévre és az NTFS-névre vonatkozó követelményeknek is. Ezeknek a követelményeknek az az oka, hogy a fájlok átmásolhatók a blobtárolóból egy helyi NTFS-lemezre feldolgozás céljából.

Hosszú ideig futó műveletek

Az Azure Media Services swagger-fájljaiban megjelölt x-ms-long-running-operation műveletek hosszú ideig futó műveletek.

Az aszinkron Azure-műveletek nyomon követésével kapcsolatos részletekért lásd: Aszinkron műveletek.

A Media Services a következő hosszú ideig futó műveletekkel rendelkezik:

Egy hosszú művelet sikeres elküldésekor "201 Létrehozva" érkezik, és le kellkérdeznie a művelet befejezését a visszaadott műveletazonosító használatával.

Az aszinkron Azure-műveletek nyomon követése című cikk részletesen ismerteti, hogyan követheti nyomon az aszinkron Azure-műveletek állapotát a válaszban visszaadott értékeken keresztül.

Egy adott élő eseményhez vagy a hozzá tartozó élő kimenetekhez csak egy hosszú ideig futó művelet támogatott. Az indítást követően egy hosszú ideig futó műveletet végre kell hajtani, mielőtt egy későbbi hosszú ideig futó műveletet indítanának ugyanazon a LiveEventen vagy bármely kapcsolódó élő kimeneten. Több élő kimenettel rendelkező élő események esetén egy hosszú ideig futó művelet befejezésére kell várnia egy élő kimeneten, mielőtt egy hosszú ideig futó műveletet aktivál egy másik élő kimeneten.

SDK-k

Megjegyzés

Az Azure Media Services v3 SDK-k nem garantáltan szálbiztosak. Többszálú alkalmazás fejlesztésekor saját szálszinkronizálási logikát kell hozzáadnia az ügyfél védelméhez, vagy szálonként egy új AzureMediaServicesClient objektumot kell használnia. Ügyeljen arra is, hogy a kód által az ügyfélnek biztosított opcionális objektumok (például a .NET HttpClient-példánya) által bevezetett többszálúsági problémákat is tapasztalja.

SDK Referencia
.NET SDK .NET-referencia
Java SDK Java-referencia
Python SDK Python-referencia
Node.js SDK Node.js-referencia
Go SDK Go-referencia

Lásd még

Azure Media Services Explorer

Az Azure Media Services Explorer (AMSE) olyan windowsos ügyfelek számára elérhető eszköz, akik szeretnék megismerni a Media Services szolgáltatást. Az AMSE egy Winforms/C#-alkalmazás, amely a Media Services szolgáltatással feltölti, letölti, kódolja, streameli a VOD-t és élő tartalmakat. Az AMSE eszköz olyan ügyfelek számára készült, akik kód írása nélkül szeretnék tesztelni a Media Servicest. Az AMSE-kód erőforrásként érhető el a Media Services szolgáltatással fejleszteni kívánt ügyfelek számára.

Az AMSE egy nyílt forráskódú projekt, a támogatást a közösség biztosítja (a problémákat jelentheti a következőnek https://github.com/Azure/Azure-Media-Services-Explorer/issues: ). A projekt a Microsoft nyílt forráskódú projekteket szabályozó etikai kódexe, a Microsoft Open Source Code of Conduct hatálya alá esik. További információkért tekintse meg a viselkedési szabályzat GYIK-ját , vagy vegye fel a kapcsolatot opencode@microsoft.com más kérdésekkel vagy megjegyzésekkel.

Media Services-entitások szűrése, rendezése, lapozása

Lásd: Azure Media Services-entitások szűrése, rendezése és lapozása.

Súgó és támogatás

Kérdéseivel kapcsolatba léphet a Media Services szolgáltatással, vagy követheti a frissítéseket az alábbi módszerek egyikével: