Share via

Media Services v3 API’leri ile geliştirme

  • Makale

Media Services logosu v3

Uyarı

Azure Media Services 30 Haziran 2024'de kullanımdan kaldırılacak. Daha fazla bilgi için bkz. AMS Kullanımdan Kaldırma Kılavuzu.

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 ve Go) için 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ştirme yaparken varlıklar ve API'ler için geçerli olan kurallar açıklanır.

Uyarı

Üretim amacıyla düzgün bir şekilde yapmak 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 gerekeceğinden, Media Services için REST API'yi doğrudan kendi kitaplık kodunuz içine sarmaya çalışmanız önerilmez. Bu, çeşitli diller (.NET, Java, TypeScript, Python vb.) için istemci SDK'ları tarafından otomatik olarak işlenir ve yeniden deneme mantığıyla veya başarısız API çağrılarıyla ilgili sorun yaşama olasılığınızı azaltır. İstemci SDK'ları bunu sizin için zaten halleder.

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 Bir Hizmet Sorumlusu ile Media Services'e bağlanan bir orta katman olmalıdır.
  • 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. API'ye Okuyucu rolüyle erişilebilir, ancak yalnızca Al veya Listele işlemleri kullanılabilir. Daha fazla bilgi için bkz. Media Services hesapları için Azure rol tabanlı erişim denetimi (Azure RBAC).

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?.

hizmet sorumlusu Azure AD

Azure AD uygulaması ve hizmet sorumlusu aynı kiracıda olmalıdır. Uygulamayı oluşturduktan sonra, uygulamaya Media Services hesabına Katkıda Bulunan veya Sahip rolü erişimi verin.

Azure AD uygulaması oluşturma izinlerinizin olup olmadığından emin değilseniz bkz. Gerekli izinler.

Aşağıdaki şekilde, sayılar isteklerin akışını kronolojik sırada temsil eder:

Web API'sinden AAD ile orta katman uygulama kimlik doğrulaması

  1. Orta katman uygulaması, aşağıdaki parametrelere sahip bir Azure AD erişim belirteci istemektedir:

    • Kiracı uç noktasını Azure AD.
    • Media Services kaynak URI'si.
    • REST Media Services için kaynak URI'si.
    • uygulama değerlerini Azure AD: istemci kimliği ve gizli anahtar.

    Gerekli tüm değerleri almak için bkz. Azure Media Services API'sine erişme.

  2. Azure AD erişim belirteci orta katmana gönderilir.

  3. Orta katman, Azure AD belirteci ile Azure Media REST API'sine istek gönderir.

  4. Orta katman, Media Services'dan verileri geri alır.

Örnekler

Azure AD hizmet sorumlusuyla nasıl bağlanıldığını gösteren aşağıdaki örneklere bakın:

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 kaynak adları şunları içeremez: '<', '', '>%', '&', ':', '\', '?', '/', '*', '+', '.', 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.

Azure Resource Manager adlandırma hakkında daha fazla bilgi için bkz. Adlandırma gereksinimleri ve Adlandırma kuralları.

Varlık içindeki dosyaların/blobların adları

Bir varlıktaki dosyaların/blobların adları hem blob adı gereksinimlerini hem de NTFS adı gereksinimlerini karşılamalıdır. Bu gereksinimlerin nedeni, dosyaların işlenmek üzere blob depolamadan yerel bir NTFS diskine kopyalanabilir olmasıdır.

Uzun süre çalışan işlemler

Azure Media Services swagger dosyalarında ile x-ms-long-running-operation işaretlenen işlemler 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'ın uzun süre çalışan şu işlemleri vardır:

Uzun bir işlemin başarıyla gönderilmesi üzerine bir '201 Oluşturuldu' alırsınız ve döndürülen işlem kimliğini kullanarak işlemin tamamlanmasını 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 izlenmesi ayrıntılı olarak açıklanmaktadır.

Belirli bir Canlı Etkinlik veya ilişkili Canlı Çıktılardan herhangi biri için yalnızca bir uzun süre çalışan işlem desteklenir. Başlatıldıktan sonra, uzun süre çalışan bir işlemin aynı LiveEvent veya ilişkili Canlı Çıkışlar üzerinde uzun süre çalışan bir işlem başlatmadan önce tamamlanması gerekir. Birden çok Canlı Çıkışa sahip Canlı Etkinlikler için, başka bir Canlı Çıkışta uzun süre çalışan bir işlemi tetiklemeden önce bir Canlı Çıktıda uzun süre çalışan bir işlemin tamamlanmasını beklemeniz gerekir.

SDK

Not

Azure Media Services v3 SDK'larının iş parçacığı güvenli olacağı garanti değildir. Çok iş parçacıklı bir uygulama geliştirirken istemciyi korumak için kendi iş parçacığı eşitleme mantığınızı eklemeniz veya iş parçacığı başına yeni bir AzureMediaServicesClient nesnesi kullanmanız gerekir. Ayrıca, kodunuz tarafından istemciye sağlanan isteğe bağlı nesneler (.NET'teki bir HttpClient örneği gibi) tarafından ortaya sürülmüş çok iş parçacıklı sorunlara da dikkat etmelisiniz.

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

Ayrıca bkz.

Azure Media Services Gezgini

Azure Media Services Gezgini (AMSE), Media Services hakkında bilgi edinmek isteyen Windows müşterilerinin kullanabileceği bir araçtır. AMSE, Media Services ile VOD ve canlı içerik yükleyen, indiren, kodlayan, akışla aktaran bir Winforms/C# uygulamasıdır. AMSE aracı, Herhangi bir kod yazmadan Media Services'i test etmek isteyen istemcilere yöneliktir. AMSE kodu, Media Services ile geliştirmek isteyen müşteriler için bir kaynak olarak sağlanır.

AMSE bir Açık Kaynak projesidir, topluluk tarafından destek sağlanır (sorunlar olarak https://github.com/Azure/Azure-Media-Services-Explorer/issuesbildirilebilir). Bu proje Microsoft Open Source Code of Conduct (Microsoft Açık Kaynak Kullanım Kuralları) belgesinde listelenen kurallara uygundur. Daha fazla bilgi için Kullanım Kuralları hakkında SSS bölümüne bakın veya diğer sorularınız veya yorumlarınızla iletişime geçin opencode@microsoft.com .

Media Services varlıklarını filtreleme, sıralama, sayfalama

Bkz. Azure Media Services varlıklarını filtreleme, sıralama, sayfalama.

Yardım ve destek alma

Sorularınız için Media Services ile iletişime geçebilir veya aşağıdaki yöntemlerden birini kullanarak güncelleştirmelerimizi izleyebilirsiniz: