Media Services v3 API’leri ile geliştirme
v2 Media Services mı arayabilirsiniz?
Geliştirici olarak, özel medya iş akışlarını kolayca oluşturmak, yönetmek ve bakımını yapmak için REST API ile etkileşim kurmanızı sağlayan (.NET, Python, Node.js, Java, Go ve Ruby) istemci kitaplıklarını kullanabilirsiniz. Media Services v3 API'si, OpenAPI belirtimini (eski adıyla Swagger) temel alır.
Bu makalede, Media Services v3 ile geliştirirken varlıklara ve API'lere Media Services tartışılmıştır.
Uyarı
Media Services için REST API'yi doğrudan kendi kitaplık kodunuz içine sarmaya çalışmanız önerilir çünkü üretim amacıyla bunu düzgün yapmak için tam Azure Kaynak Yönetimi yeniden deneme mantığını uygulamanız ve Azure Kaynak Yönetimi API'lerinde uzun süre çalışan işlemleri yönetmeyi anlamanız gerekebilir. Bu, .NET, Java, TypeScript, Python, Ruby vb. gibi çeşitli diller için istemci SDK'leri tarafından otomatik olarak kullanılmaktadır ve mantıkla veya başarısız API çağrılarında sorun yaşama ihtimalini azaltır. İstemci SDK'leri bunu sizin için zaten ele almaktadır. Postman koleksiyonu bir öğretim aracı olarak daha fazla sağlanır ve çeşitli istemci SDK'leriyle geliştirmeniz sırasında istemci SDK'larının gerçekten kablo üzerinde ne yaptığını göstermek için sağlanır.
Azure Media Services API'sine erişme
Media Services kaynaklarına ve Media Services API'sine erişim yetkisi almak için önce kimliğinizi doğrulamanız gerekir. Media Services, Azure Active Directory (Azure AD) tabanlı kimlik doğrulamasını destekler. İki yaygın kimlik doğrulaması seçeneği vardır:
- Hizmet sorumlusu kimlik doğrulaması: Hizmetin kimliğini doğrulamak için kullanılır (örneğin: web uygulamaları, işlev uygulamaları, API ve mikro hizmetler). Bu kimlik doğrulama yöntemini yaygın olarak kullanan uygulamalar deamon hizmetleri, orta katman hizmetleri veya zamanlanmış işler çalıştıran uygulamalardır. Örneğin, web uygulamaları için her zaman hizmet sorumlusuyla bağlantı Media Services orta katman olması gerekir.
- Kullanıcı kimlik doğrulaması: Uygulamayı Media Services kaynaklarıyla etkileşim kurmak amacıyla kullanan bir kişinin kimliğini doğrulamak için kullanılır. Etkileşimli uygulamanın önce kullanıcıdan kimlik bilgilerini istemesi gerekir. Yetkili kullanıcılar tarafından kodlama işlerini veya canlı akışı izlemek için kullanılan yönetim konsolu uygulaması bunun bir örneğidir.
Media Services API'si, REST API isteklerinde bulunan kullanıcının veya uygulamanın Media Services hesabı kaynağına erişimi olmasını ve Katkıda Bulunan veya Sahip rolü kullanmasını gerektirir. Okuyucu rolüyle API'ye erişilebilir ama yalnızca Get veya List işlemleri kullanılabilir.Daha fazla bilgi için bkz. Azure rol tabanlı erişim denetimi (Azure RBAC) Media Services hesapları.
Hizmet sorumlusu oluşturmak yerine, Azure kaynakları için yönetilen kimlikler kullanarak Azure Resource Manager aracılığıyla Media Services API'sine erişmeyi göz önünde bulundurun. Azure kaynakları için yönetilen kimlikler hakkında daha fazla bilgi edinmek için bkz. Azure kaynakları için yönetilen kimlikler nedir?.
Azure AD hizmet sorumlusu
Azure AD uygulaması ve hizmet sorumlusu aynı kiracıda yer alır. Uygulamayı oluşturduk sonra, uygulamanın Katkıda Bulunanı veya Sahip rolüne Media Services ver.
Azure AD uygulaması oluşturma izinlerine sahip olup olmadığınızı emin değilsanız bkz. Gerekli izinler.
Aşağıdaki şekilde, sayılar isteklerin akışını kronolojik sırada temsil ediyor:
Orta katman uygulaması, aşağıdaki parametrelere sahip bir Azure AD erişim belirteci talep eder:
- Azure AD kiracı uç noktası.
- Media Services URI'sı.
- REST için kaynak URI'Media Services.
- Azure AD uygulama değerleri: istemci kimliği ve gizli istemci.
Tüm gerekli değerleri almak için bkz. Api'Azure Media Services erişme.
Azure AD erişim belirteci orta katmana gönderilir.
Orta katman, Azure AD belirteci ile REST API Azure Media REST API hizmetine istek gönderir.
Orta katman verileri veri kaynağından Media Services.
Örnekler
Azure AD hizmet sorumlusuna bağlanmayı göstermek için aşağıdaki örneklere bakın:
- .NET ile bağlanma
- Node.js ile bağlanma
- Python ile bağlanma
- Java ile bağlanma
- Bağlan REST ile birlikte
Adlandırma kuralları
Azure Media Services v3 kaynaklarının adları (Varlıklar, İşler, Dönüşümler gibi), Azure Resource Manager adlandırma kısıtlamalarına tabidir. Azure Resource Manager uyarınca kaynak adları her zaman benzersizdir. Bu nedenle kaynaklarınızda benzersiz tanıtıcı dizeleri (GUID gibi) kullanabilirsiniz.
Media Services adları şunları içerebilir: '<', '>', '%', '&', ':', '\', '?', '/', '*', '+', '.', tek tırnak karakteri veya herhangi bir denetim karakteri. Diğer tüm karakterlere izin verilir. Bir kaynağın adı en fazla 260 karakter olabilir.
Adlandırma hakkında daha fazla Azure Resource Manager için bkz. Adlandırma gereksinimleri ve Adlandırma kuralları.
Bir varlık içindeki dosyaların/blobların adları
Bir varlık içindeki dosya/blob adlarının hem blob adı gereksinimlerini hem de NTFS ad gereksinimlerini izlemesi gerekir. Bu gereksinimlerin nedeni, dosyaların iş için blob depolamadan yerel bir NTFS diske kopyalanmasıdır.
Uzun süre çalışan işlemler
Swagger x-ms-long-running-operation dosyalarında Azure Media Services işlemleri uzun süre çalışan işlemlerdir.
Zaman uyumsuz Azure işlemlerini izleme hakkında ayrıntılı bilgi için bkz. Zaman uyumsuz işlemler.
Media Services uzun süre çalışan işlemlere sahip olabilir:
-
Olayı
removeOutputsOnStopdurduruyorken ilişkili tüm Canlı Çıkışları silmek için parametresini kullanın.
Uzun bir işlem başarıyla gönderilenin ardından bir '201 Oluşturuldu' alırsınız ve döndürülen işlem kimliğini kullanarak işlem tamamlandıktan sonra yoklamanız gerekir.
Zaman uyumsuz Azure işlemlerini izleme makalesinde, yanıtta döndürülen değerler aracılığıyla zaman uyumsuz Azure işlemlerinin durumunun nasıl iz sürecesi ayrıntılı olarak açıklanmıştır.
Belirli bir Canlı Etkinlik veya ilişkili Canlı Çıkışlar için yalnızca bir uzun süre çalışan işlem de destekler. Başlatıldıktan sonra, uzun süre çalışan bir işlem, aynı LiveEvent'de veya ilişkili tüm Canlı Çıkışlarda sonraki bir uzun süre çalışan işlemi başlatmadan önce tamamlanır. Birden çok Canlı Çıkış içeren Canlı Etkinlikler için, başka bir Canlı Çıkışta uzun süre çalışan bir işlemi tetiklemeden önce bir Canlı Çıkışta uzun süre çalışan bir işlem tamamlanmasını bekleysiniz.
SDK
Not
Azure Media Services v3 VM'leri iş parçacığı güvenli olmaz. Çok iş parçacıklı bir uygulama geliştirme sırasında, istemciyi korumak için kendi iş parçacığı eşitleme mantığınızı eklemeniz veya iş parçacığı başına yeni bir AzureMediaServicesClient nesnesi kullansanız gerekir. Ayrıca, kodunuz tarafından istemciye (.NET'te HttpClient örneği gibi) sağlanan isteğe bağlı nesneler tarafından ortaya konulan çok iş parçacığı sorunlarına da dikkat edin.
| SDK | Başvuru |
|---|---|
| .NET SDK | .NET başvurusu |
| Java SDK | Java başvurusu |
| Python SDK'sı | Python başvurusu |
| Node.js SDK’sı | Node.js başvurusu |
| Go SDK'sı | Go başvurusu |
| Ruby SDK |
Ayrıca bkz.
Azure Media Services Gezgini
Azure Media Services Explorer (amo), Media Services hakkında bilgi edinmek isteyen müşteriler Windows kullanabileceğiniz bir araçtır. AMO, Media Services ile karşıya yükleme, indirme, kodlama, akış ve canlı içerik akışı yapan bir WinForms/C# uygulamasıdır. amo aracı, herhangi bir kod yazmadan Media Services test etmek isteyen istemcilere yöneliktir. AMI kodu, Media Services geliştirmek isteyen müşteriler için bir kaynak olarak sağlanır.
AMO bir açık kaynak projem, topluluk tarafından destek sağlanır (sorunlar olarak bildirilebilir https://github.com/Azure/Azure-Media-Services-Explorer/issues) . Bu proje Microsoft Open Source Code of Conduct (Microsoft Açık Kaynak Kullanım Kuralları) belgesinde listelenen kurallara uygundur. Daha fazla bilgi için bkz. kullanım KURALLARı SSS veya opencode@microsoft.com diğer soru veya açıklamalarla iletişim kurma.
Media Services varlıkların filtrelenmesi, sıralanması, sayfalama
bkz. Azure Media Services varlıkların filtrelenmesi, sıralanması, sayfalama.
Soru sorun, geri bildirimde bulunun, güncelleştirmeleri al
soru sormak, geri bildirimde bulunmak ve Media Services hakkında güncelleştirmeler almak için Azure Media Services community makalesine göz atın.
Ayrıca bkz.
gerekli tüm değerleri almak için bkz. erişim Azure Media Services apı 'si.