Öğretici: Uzak dosya tabanlı URL kodlama ve video akışı yapma - REST

Azure Media Services medya dosyalarınızı çok çeşitli tarayıcılarda ve cihazlarda oynanacak biçimlerde kodlamanızı sağlar. Örneğin, içeriğinizi Apple'ın HLS veya MPEG DASH biçimlerinde akışla göndermek isteyebilirsiniz. Akışla göndermeden önce yüksek kaliteli dijital medya dosyanızı kodlamanız gerekir. Kodlama yönergeleri için bkz. Kodlama kavramı.

Bu öğreticide, BIR URL'yi temel alan bir dosyayı kodlama ve REST kullanarak videonun akışını Azure Media Services nasıl Azure Media Services gösterir.

Bu öğretici şunların nasıl yapıldığını gösterir:

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

• Bir Media Services oluşturun.

  Kaynak grubu adı ve hesap adı için kullanılan değerleri Media Services emin olun

• AMS REST öğreticilerinden bazılarında gösterilen REST API'lerini yürütmek için Postman REST istemcisini yükleyin.

  Biz Postman'ı kullanıyoruz, ancak herhangi bir REST aracı da olabilir. Diğer alternatifler: REST Visual Studio Code veya Telerik Fiddler ile bağlantı.

Postman dosyalarını indirme

Postman koleksiyonunu ve ortam dosyalarını içeren bir GitHub deposunu kopyalayın.

git clone https://github.com/Azure-Samples/media-services-v3-rest-postman.git

Erişim API’si

Ayrıntılı bilgi için bkz. API'ye erişmek için Media Services edinin

Postman'i yapılandırma

Ortamı yapılandırma

1. Postman uygulamasını açın.

2. Ekranın sağ tarafında Ortamı yönet seçeneğini belirleyin.

   

3. Ortamı yönet iletişim kutusunda İçe aktar'ı tıklatın.

4. https://github.com/Azure-Samples/media-services-v3-rest-postman.git kopyasını oluşturduğunuzda indirilen Azure Media Service v3 Environment.postman_environment.json dosyasına gidin.

5. Azure Media Service v3 Environment ortamı eklenir.

   Not

   Erişim değişkenlerini yukarıdaki Media Services API'sine erişme bölümünden aldığınız değerlerle güncelleştirin.

6. Seçili dosyaya çift tıklayın ve API'ye erişim adımlarını izleyerek aldığınız değerleri girin.

7. İletişim kutusunu kapatın.

8. Aşağı açılan listeden Azure Media Service v3 Environment ortamını seçin.

   

Koleksiyonu yapılandırma

1. Koleksiyon dosyasını içe aktarmak için İçe Aktar'ı tıklatın.

2. https://github.com/Azure-Samples/media-services-v3-rest-postman.git kopyasını oluşturduğunuzda indirilen Media Services v3.postman_collection.json dosyasına gidin

3. Media Services v3.postman_collection.json dosyasını seçin.

   

Postman kullanarak istek gönderme

Bu bölümde, dosyanızı akışla aktarabilmeniz için kodlama ve URL oluşturma ile ilgili istekler göndereceğiz. Özellikle de aşağıdaki istekleri göndereceğiz:

1. Hizmet Sorumlusu Kimlik Doğrulaması için Azure AD Belirteci alma
2. Akış Uç Noktası Başlatma
3. Çıktı varlığı oluşturma
4. Dönüşüm Oluşturma
5. İş Oluşturma
6. Akış Bulucu oluşturma
7. Akış Bulucu'ların yollarını listele

Azure AD Belirteci alma

1. Postman uygulamasının sol penceresinde "1. Adım: AAD Kimlik Doğrulama belirteci al"ı seçin.

2. Sonra, "Hizmet Sorumlusu Kimlik Doğrulaması için Azure AD Belirteci alma"'yı seçin.

3. Gönder’e basın.

   Aşağıdaki POST işlemi gönderilir.

   https://login.microsoftonline.com/:aadTenantDomain/oauth2/token
   

4. Yanıt belirteç ile gelir ve "AccessToken" ortam değişkenini belirteç değerine ayarlar. "AccessToken"'ı ayarlayan kodu görmek için Testler sekmesine tıklayın.

   

Akış Uç Noktası Başlatma

Akışı etkinleştirmek için öncelikle videonun akışını yapmak istediğiniz Akış Uç Noktasını başlatmamız gerekir.

1. Postman uygulamasının sol penceresinde "Akış ve Canlı"'ı seçin.

2. Ardından "StreamingEndpoint'i Başlat"ı seçin.

3. Gönder’e basın.

   • Aşağıdaki POST işlemi gönderilir:

     https://management.azure.com/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaservices/:accountName/streamingEndpoints/:streamingEndpointName/start?api-version={{api-version}}
     

   • İstek başarılı olursa Status: 202 Accepted döndürülür.

     Bu durum, isteğin iş için kabul edildi anlamına gelir; ancak, işleme tamamlanmadı. Yanıt üst bilgisinde yer alan değere göre işlem durumunu Azure-AsyncOperation sorguabilirsiniz.

     Örneğin, aşağıdaki GET işlemi işleminizin durumunu döndürür:

     https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/<resourceGroupName>/providers/Microsoft.Media/mediaservices/<accountName>/streamingendpointoperations/1be71957-4edc-4f3c-a29d-5c2777136a2e?api-version=2018-07-01

     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.

Çıktı varlığı oluşturma

Çıktı Varlığı, kodlama işinizin sonucunu depolar.

1. Postman uygulamasının sol penceresinde "Varlıklar"ı seçin.

2. Ardından "Varlık oluşturma veya güncelleştirme"'yi seçin.

3. Gönder’e basın.

   • Aşağıdaki PUT işlemi gönderilir:

     https://management.azure.com/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaServices/:accountName/assets/:assetName?api-version={{api-version}}
     

   • İşlemin gövdesi aşağıdaki gibidir:

     {
     "properties": {
         "description": "My Asset",
         "alternateId" : "some GUID",
         "storageAccountName": "<replace from environment file>",
         "container": "<supply any valid container name of your choosing>"
      }
     }
     

Dönüşüm oluşturma

Media Services’te içerik kodlarken veya işlerken, kodlama ayarlarını bir tarif olarak ayarlamak yaygın bir modeldir. Daha sonra bu tarifi bir videoya uygulamak üzere bir İş gönderirsiniz. Her yeni video için yeni işler göndererek bu tarifi kitaplığınız içinde yer alan tüm videolara uyguluyor oluruz. Media Services içinde tarif, Dönüşüm olarak adlandırılır. Daha fazla bilgi için Dönüşümler ve İşler konusuna bakın. Bu öğreticide açıklanan örnek, videoyu çeşitli iOS ve Android cihazlarına akışla aktarmak için kodlayan bir tarifi tanımlar.

Yeni bir Dönüşüm örneği oluştururken çıktı olarak neyi üretmesi istediğinizi belirtmeniz gerekir. Gerekli parametre bir TransformOutput nesnesidir. Her TransformOutput bir Ön ayar içerir. Ön ayar, video ve/veya ses işleme işlemlerinin istenen TransformOutput nesnesini oluşturmak üzere kullanılacak adım adım yönergelerini açıklar. Bu makalede açıklanan örnek, AdaptiveStreaming adlı yerleşik bir Ön Ayar kullanır. Ön Ayar, giriş çözünürlüğü ve bit hızını temel alarak, giriş videosunu otomatik olarak oluşturulan bir bit hızı basamağına (bit hızı-çözünürlük çiftleri) kodlar ve her bir bit hızı-çözünürlük çiftine karşılık gelen H.264 video ve AAC sesi ile ISO MP4 dosyaları üretir. Bu Ön Ayar hakkında bilgi için bkz. otomatik oluşturulan bit hızı basamağı.

Yerleşik bir EncoderNamedPreset ön ayarını veya özel ön ayarları kullanabilirsiniz.

1. Postman uygulamasının sol penceresinde "kodlama ve analiz" seçeneğini belirleyin.

2. Ardından, "Dönüşüm Oluşturma"'yı seçin.

3. Gönder’e basın.

   • Aşağıdaki PUT işlemi gönderilir.

     https://management.azure.com/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaServices/:accountName/transforms/:transformName?api-version={{api-version}}
     

   • İşlemin gövdesi aşağıdaki gibidir:

     {
         "properties": {
             "description": "Standard Transform using an Adaptive Streaming encoding preset from the library of built-in Standard Encoder presets",
             "outputs": [
                 {
                 "onError": "StopProcessingJob",
             "relativePriority": "Normal",
                 "preset": {
                     "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
                     "presetName": "AdaptiveStreaming"
                 }
                 }
             ]
         }
     }
     

Bir iş oluşturma

Burada İş, oluşturulan Dönüşümü belirli bir video girdisine veya ses içeriğine uygulamak için Media Services'e gönderilen istektir. İş giriş videosunun konumu ve çıktının konumu gibi bilgileri belirtir.

Bu örnekte, işin girişi bir HTTPS URL 'sini ("https: / /nimbuscdn-nimbuspm.streaming.mediaservices.Windows.net/2b533311-B215-4409-80AF-529c3e853622/") temel alır.

1. Postman uygulamasının sol penceresinde "kodlama ve analiz" seçeneğini belirleyin.

2. Ardından "İş Oluşturma veya Güncelleştirme"'yi seçin.

3. Gönder’e basın.

   • Aşağıdaki PUT işlemi gönderilir.

     https://management.azure.com/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaServices/:accountName/transforms/:transformName/jobs/:jobName?api-version={{api-version}}
     

   • İşlemin gövdesi aşağıdaki gibidir:

     {
     "properties": {
         "input": {
         "@odata.type": "#Microsoft.Media.JobInputHttp",
         "baseUri": "https://nimbuscdn-nimbuspm.streaming.mediaservices.windows.net/2b533311-b215-4409-80af-529c3e853622/",
         "files": [
                 "Ignite-short.mp4"
             ]
         },
         "outputs": [
         {
             "@odata.type": "#Microsoft.Media.JobOutputAsset",
             "assetName": "testAsset1"
         }
         ]
     }
     }
     

İşin tamamlanması biraz sürüyor ve tamamlandığında bildirim almak istiyorsunuz. İşin ilerleme durumunu görmek için Event Grid'in kullanılmasını öneririz. Event Grid yüksek kullanılabilirlik, tutarlı performans ve dinamik ölçek için tasarlanmıştır. Event Grid ile uygulamalarınız neredeyse tüm Azure hizmetleri ve özel kaynaklardan gelen olayları takip edip bu olaylara yanıt verebilir. Basit, HTTP tabanlı reaktif olay işleme özelliği, olayların akıllı filtrelenmesi ve yönlendirilmesi sayesinde etkili çözümler oluşturmanıza yardımcı olur. Bkz. Olayları özel bir web uç noktasına yönlendirme.

İş genellik şu aşamalardan geçer: Zamanlandı, Kuyruğa Alındı, İşleniyor, Tamamlandı (son aşama). İş bir hatayla karşılaştıysa Hata durumunu alırsınız. İş iptal edilme sürecindeyse İptal Ediliyor ve İptal Edildi durumunu alırsınız.

İş hata kodları

Bkz. hata kodları.

Akış bulucusu oluşturma

Kodlama işi tamamlandıktan sonra, bir sonraki adım çıktı kıymetindeki videonun kayıttan yürütmeye yönelik olarak kullanılabilmesini sağlar. Bunu iki adımda gerçekleştirebilirsiniz: ilk olarak, bir StreamingLocator oluşturun ve ikinci olarak, istemcilerin kullanabildiği akış URL’lerini derleyin.

Akış Bulucu oluşturma işlemine yayımlama denir. Varsayılan olarak, akış bulucu, API çağrılarını yaptıktan hemen sonra geçerli olur ve isteğe bağlı başlangıç ve bitiş zamanlarını yapılandırmadıkça silinene kadar sürer.

Bir StreamingLocator oluştururken istenen StreamingPolicyName değerini belirtmeniz gerekir. Bu örnekte, Açık (veya şifreli olmayan) içerik akışını, böylece önceden tanımlanmış açık akış ilkesi "Predefined_ClearStreamingOnly" kullanılır.

Medya hizmeti hesabınızın akış ilkesi girişi sayısı için bir kotası vardır. Her bir akış bulucu için yeni bir akış ilkesi oluşturmamalısınız.

1. Postman uygulamasının sol penceresinde "akış Ilkeleri ve Konumlandırıcı" öğesini seçin.

2. Ardından "akış Bulucu oluştur (Temizle)" öğesini seçin.

3. Gönder’e basın.

   • Aşağıdaki PUT işlemi gönderilir.

     https://management.azure.com/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaServices/:accountName/streamingLocators/:streamingLocatorName?api-version={{api-version}}
     

   • İşlemin gövdesi aşağıdaki gibidir:

     {
       "properties": {
         "streamingPolicyName": "Predefined_ClearStreamingOnly",
         "assetName": "testAsset1",
         "contentKeys": [],
         "filters": []
      }
     }
     

Yolları listeleme ve akış URL'lerini derleme

Yolları listeleme

Akış bulucunun oluşturuldığına göre, akış URL 'lerini alabilirsiniz

1. Postman uygulamasının sol penceresinde "akış Ilkeleri" ni seçin.

2. Ardından, "Yolları Listele"'yi seçin.

3. Gönder’e basın.

   • Aşağıdaki POST işlemi gönderilir.

     https://management.azure.com/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaServices/:accountName/streamingLocators/:streamingLocatorName/listPaths?api-version={{api-version}}
     

   • İşlemin gövdesi yoktur:

4. Akış için kullanmak istediğiniz yollardan birini not edin; sonraki bölümde kullanacaksınız. Burada aşağıdaki yollar döndürülür:

   "streamingPaths": [
       {
           "streamingProtocol": "Hls",
           "encryptionScheme": "NoEncryption",
           "paths": [
               "/cdb80234-1d94-42a9-b056-0eefa78e5c63/Ignite-short.ism/manifest(format=m3u8-aapl)"
           ]
       },
       {
           "streamingProtocol": "Dash",
           "encryptionScheme": "NoEncryption",
           "paths": [
               "/cdb80234-1d94-42a9-b056-0eefa78e5c63/Ignite-short.ism/manifest(format=mpd-time-csf)"
           ]
       },
       {
           "streamingProtocol": "SmoothStreaming",
           "encryptionScheme": "NoEncryption",
           "paths": [
               "/cdb80234-1d94-42a9-b056-0eefa78e5c63/Ignite-short.ism/manifest"
           ]
       }
   ]
   

Akış URL'lerini derleme

Bu bölümde HLS akış URL'sini derleyeceğiz. URL'ler aşağıdaki değerlerden oluşur:

1. Veri gönderme protokolü. Burada "https".

   Not

   Oynatıcı bir https sitesinde barındırılıyorsa, "https" URL’sini güncelleştirdiğinizden emin olun.

2. StreamingEndpoint'in konak adı. Burada "amsaccount-usw22.streaming.media.azure.net".

   Ana bilgisayar adını almak için aşağıdaki GET işlemini kullanabilirsiniz:

   https://management.azure.com/subscriptions/00000000-0000-0000-0000-0000000000000/resourceGroups/:resourceGroupName/providers/Microsoft.Media/mediaservices/:accountName/streamingEndpoints/default?api-version={{api-version}}
   

   ve resourceGroupName accountName parametrelerini ortam dosyası ile eşleşecek şekilde ayarladığınızdan emin olun.

3. Önceki bölümde (Yolları listeleme) aldığınız yol.

Sonuç olarak, aşağıdaki HLS URL'si derlenir

https://amsaccount-usw22.streaming.media.azure.net/cdb80234-1d94-42a9-b056-0eefa78e5c63/Ignite-short.ism/manifest(format=m3u8-aapl)

Akış URL’sini test etme

Bu makalede, akışı test etmek için Azure Media Player kullanılmaktadır.

1. Bir Web tarayıcısı açın ve adresine gidin https://aka.ms/azuremediaplayer/ .
2. URL: kutusuna derlediğiniz URL'yi yapıştırın.
3. Oynatıcıyı Güncelleştir düğmesine basın.

Azure Media Player, test için kullanılabilir, ancak üretim ortamında kullanılmamalıdır.

Media Services hesabınızdaki kaynakları temizleme

Genellikle, yeniden kullanmayı planladığınız nesneler hariç her şeyi temizlemeniz gerekir (genellikle dönüşümleri yeniden kullanacaksınız ve akış bulleyicileri, vb.). Deneme sonrasında hesabınızın temiz olmasını istiyorsanız, yeniden kullanmayı planlamadığınız kaynakları silmeniz gerekir.

Bir kaynağı silmek için, silmek istediğiniz kaynağın altından "Sil ..." işlemini seçin.

Kaynakları temizleme

Bu öğreticide oluşturduğunuz Media Services ve depolama hesapları dahil olmak üzere, kaynak grubunuzdaki kaynaklardan herhangi birine artık ihtiyacınız yoksa kaynak grubunu silebilirsiniz.

Aşağıdaki CLı komutunu yürütün:

az group delete --name amsResourceGroup

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.

Sonraki adımlar

Videonuzu karşıya yükleme, kodlama ve akışla aktarma hakkında bilgi edindiğinize göre aşağıdaki makaleye bakabilirsiniz: