Kanal

Makale
07/19/2023

Azure Media Services'te (AMS), Kanal varlığı canlı akış içeriğini işlemeye yönelik bir işlem hattını temsil eder. Kanal, canlı giriş akışlarını iki yoldan biriyle alır:

Şirket içi canlı kodlayıcı kanala çok bit hızlı RTMP veya Smooth Streaming (Parçalanmış MP4) gönderir. Çoklu bit hızı Kesintisiz Akış çıktısı sağlayan şu gerçek zamanlı kodlayıcıları kullanabilirsiniz: MediaExcel, Imagine Communications, Ateme, Envivio, Cisco ve Elemental. Şu gerçek zamanlı kodlayıcılar RTMP çıktısı sağlar: Adobe Flash Live Encoder, Haivision, Telestream Wirecast, Teradek ve Tricaster kodlayıcılar. Alınan akışlar kanallardan başka işlem yapmadan geçer. İstendiğinde, Media Services akışı müşterilere teslim eder.
Media Services ile canlı kodlama gerçekleştirmek için etkinleştirilen öğesine tek bir bit hızı akışı (aşağıdaki biçimlerden birinde: RTP (MPEG-TS), RTMPveya Smooth Streaming (Parçalanmış MP4)) gönderilir Channel . daha Channel sonra gelen tek bit hızı akışının çoklu bit hızı (uyarlamalı) video akışına canlı kodlamasını gerçekleştirir. İstendiğinde, Media Services akışı müşterilere teslim eder.

Media Services 2.10 sürümünden başlayarak, bir Kanal oluşturduğunuzda, kanalınızın giriş akışını almasını istediğiniz yolu ve kanalın akışınızın canlı kodlamasını gerçekleştirmesini isteyip istemediğinizi belirtebilirsiniz. İki seçeneğiniz vardır:

None – Çoklu bit hızına sahip akış çıkışı veren bir şirket içi canlı kodlayıcı kullanmayı planlıyorsanız bu değeri belirtin. Bu durumda, gelen akış herhangi bir kodlama olmadan çıkışa geçirilir. Bu, kanalın 2.10 sürümünden önceki davranışıdır. Bu tür kanallarla çalışma hakkında daha ayrıntılı bilgi için bkz. Şirket İçi Kodlayıcılardan Çok Bit Hızlı Canlı Akış Alan Kanallarla Çalışma.
Standard – Tek bit hızlı canlı akışınızı çoklu bit hızı akışına kodlamak için Media Services kullanmayı planlıyorsanız bu değeri seçin.

Not

Canlı kodlama için faturalamanın bir etkisi olduğunu ve canlı kodlama kanalını "Çalışıyor" durumunda bırakmanın faturalama ücretlerine neden olacağını unutmayın. Ek saatlik ücretlerden kaçınmak için canlı akış etkinliğiniz tamamlandıktan sonra çalışan kanallarınızı hemen durdurmanız önerilir. Daha fazla bilgi için bkz. Azure Media Services ile Gerçek Zamanlı Kodlama Gerçekleştirmek İçin Etkinleştirilmiş Kanallar ile Çalışma.

Canlı Akış ve kanalları yönetme hakkında daha fazla bilgi için bkz . Azure Media Services ile Canlı Akış Sunma.

Önemli

Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'e Bağlanma.

Bu konu, varlığa genel bir bakış Channel sağlar ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.

Kanal Oluşturma
Kanalları Başlat
Kanalları Durdur
Kanalları Listele
Kanalları Sıfırla
Kanalları Güncelleştirme
Tanıtımı Başlat
Tanıtımı Sonlandır
Sayfayı Göster
Sayfayı Gizle
Kanalları Sil

Kanal Varlığı

Varlık Channel aşağıdaki özellikleri içerir.

Özellik	Tür	Description
`Id` Salt okunur. Media Services tarafından ayarlanır.	Edm.String	Oluşturma sırasında atanan Kanal Kimliği. Biçim: nb:chid:UUID:<GUID>.
`Name`	Edm.String	Kanal adı. 1. Media Services hesabınızda benzersiz olmalıdır. 2. Maksimum uzunluk = 32 karakter. 3. Boşluk içeremez. 4. Yalnızca kısa çizgiler ve alfasayısal karakterler. 5. Kısa çizgiyle başlayamaz veya bitemez.
`Created` Salt okunur. Media Services tarafından ayarlanır.	Edm.DateTime	Oluşturma saatini gösteren utc tarih/saat değeri.
`Description`	Edm.String	Kullanıcı tarafından sağlanan açıklama. Uzunluk üst sınırı 256 karakterdir.
`LastModified` Salt okunur. Media Services tarafından ayarlanır.	Edm.DateTime	Kanala yapılan son güncelleştirmenin tarihi ve saati.
`State` Salt okunur. Media Services tarafından ayarlanır.	Edm.String	Kanalın geçerli durumu. Olası değerler şunlardır: -Durdu. Bu, Kanalın oluşturulduktan sonraki ilk durumudur. Bu durumda Kanal özellikleri güncelleştirilebilir ancak akışa izin verilmez. -Başlangıç. Kanal başlatılıyor. Bu durum sırasında hiçbir güncelleştirmeye veya akışa izin verilmez. Hata oluşursa Kanal Durduruldu durumuna döner. -Çalışan. Kanal, canlı akışları işleyebilecek kapasitededir. -Durdurma. Kanal durduruluyor. Bu durum sırasında hiçbir güncelleştirmeye veya akışa izin verilmez. -Silme. Kanal siliniyor. Bu durum sırasında hiçbir güncelleştirmeye veya akışa izin verilmez.
`Input`	ChannelInput ComplexType	Kanal girişi (alma) ayarları.
`Output`	ChannelOutput ComplexType	Kanal çıkış ayarları.
`Preview`	ChannelPreview ComplexType	Kanal önizleme ayarları.
`CrossSiteAccessPolicies`	CrossSiteAccessPolicies	Siteler arası erişim ilkeleri.
`Programs` Salt okunur. Media Services tarafından ayarlanır.	Programkoleksiyonu.	Kanalla ilişkili programların koleksiyonuna başvuru.
`EncodingType`	Edm.String	`Optional`. Kanalın yapılandırmasını açıklar. İzin verilen değerler şunlardır: - `None` – Bu varsayılan değerdir. Bu değeri seçtiğinizde, gelen akış herhangi bir kodlama olmadan çıkışa geçirilir (bu, kanalın 2.10 sürümünden önceki davranışıdır). - `Standard`– Gelen tek bit hızı akışı Kanala gönderilir ve Sistem ön ayarları kullanılarak çoklu bit hızı akışına dönüştürülür
`Encoding`	ComplexType Kodlama	Azure live kodlayıcı ayarları.
`Slate`	Kayrak	Bu ayar yalnızca `Encoding Type` Kanalın değeri olarak ayarlandığında `Standard`desteklenir. Kanal içindeki canlı kodlayıcıya, bir kayrak görüntüsüne geçiş sinyali oluşturulabilir. Devam eden bir sayfayı sonlandırmak için de işaretlenebilir. Canlı kodlayıcı, belirli durumlarda (örneğin reklam molası sırasında) bir sayfa görüntüsüne geçiş yapmak ve gelen video sinyalini maskelemek için yapılandırılabilir. Böyle bir sayfa yapılandırılmamışsa, bu reklam kesintisi sırasında giriş videosu maskelenmez.

ChannelInput ComplexType

Ad	Tür	Description
`KeyFrameInterval`	Edm.Time	olarak ayarlanırsa `EncoderTypeStandard`bu değer yoksayılır. Çok bit hızlı akış oluşturmak için bir şirket içi canlı kodlayıcı kullanılırken, anahtar kare aralığı GOP süresini belirtir (bu dış kodlayıcı tarafından kullanıldığı gibi). Bu gelen akış Kanal tarafından alındıktan sonra canlı akışınızı istemci kayıttan yürütme uygulamalarına şu biçimlerden herhangi birinde sunabilirsiniz: Kesintisiz Akış, DASH ve HLS. Canlı akış yaparken HLS her zaman dinamik olarak paketlenmiş durumdadır. Media Services varsayılan olarak, canlı kodlayıcıdan alınan Resim Grubu – GOP olarak da adlandırılan anahtar çerçeve aralığına göre HLS segment paketleme oranını (segment başına parçalar) otomatik olarak hesaplar.
`StreamingProtocol` Salt okunur.	Edm.String	Kodlayıcı türünü ayarladıktan sonra bir alma protokolü ayarlayabilirsiniz. `Encoder Type` olarak ayarlanırsa `None`geçerli seçenekler şunlardır: - Çok bit hızlı Parçalanmış MP4 (Kesintisiz Akış) - Çok bit hızlı RTMP değeriniz `Encoder Type` olarak ayarlandığında `None`, tek bir bit hızlı RTMP veya Kesintisiz Akış canlı akışının gönderilmesi geçerli ancak istenmeyen bir durumdur. Kanal akışla herhangi bir işlem yapmaz, bu nedenle geçer, ancak istemci uygulamaları tek bir bit hızı akışı alır. `Encoder Type` olarak ayarlanırsa `Standard`geçerli seçenekler şunlardır: 1. Tek bit hızlı Parçalanmış MP4 (Kesintisiz Akış) 2. Tek bit hızlı RTMP 3. RTP (MPEG-TS): MPEG-2 RTP üzerinden Aktarım Akışı.
`AccessControl`	ChannelInputAccessControl ComplexType	Kanal girişi erişim denetimi ayarları.
`Endpoints` Salt okunur.	ChannelEndpoint ComplexType	Kanal giriş uç noktaları. Kanal, canlı akışınızı almak için kullandığınız giriş uç noktaları (alma URL'leri) sağlar. Kanal canlı giriş akışlarını alır ve çıkış akışlarını bir veya daha fazla akış uç noktası üzerinden akış için kullanılabilir hale getirir.

ChannelPreview ComplexType

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
`AccessControl`	ChannelPreviewAccessControl ComplexType	Kanal önizleme erişim denetimi ayarları.
`Endpoints` Salt okunur.	ChannelEndpoint ComplexType	Kanal önizleme uç noktaları.

ChannelInputAccessControl ComplexType

Ad	Tür	Description
`IP`	IPAccessControl	Kanal giriş uç noktalarına bağlanmasına izin verilen IP adresleri. IP adreslerinin şu biçimlerden birinde olması gerekir: 4 sayılı IpV4 adresi, CIDR adres aralığı.

ChannelPreviewAccessControl ComplexType

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
`IP`	IPAccessControl	Kanal giriş uç noktalarına bağlanmasına izin verilen IP adresleri. IP adreslerinin şu biçimlerden birinde olması gerekir: 4 sayılı IpV4 adresi, CIDR adres aralığı

IPAccessControl

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
İzin Ver	IPRange ComplexType	Kanal giriş uç noktalarına bağlanmasına izin verilen IP adresleri. Not: Bu değeri null olarak ayarlamak tüm IP kaynak adreslerinin bağlanmasına olanak tanır. Bunu boş bir dize ("") olarak ayarlamak, kimsenin bağlanmasına izin vermemektedir.

IPRange ComplexType

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
`Name`	Edm.String	Bu IP Aralığı için kolay bir ad.
`Address`	Edm.String	Alt ağ gösterimi için temel IP adresi (örneğin: 192.168.0.1).
`SubnetPrefixLength`	Edm.Int32	Alt ağ maskesi için önemli bit sayısı (örneğin, aşağıdaki IP adresinde 192.168.0.1/24, 24 önemli bit sayısını temsil eder).

ChannelEndpoint ComplexType

Ad	Tür	Description
`Protocol`	Edm.String	Kanal akış uç noktası protokolü.
`Url`	Edm.String	Kanal akış uç noktası URL'si.

ChannelOutput ComplexType

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilmiş Kanallara Genel Bakış

Ad	Tür	Description
`Hls`	ChannelOutputHls ComplexType	HLS'ye özgü ayarlar.

ChannelOutputHls ComplexType

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
`FragmentsPerSegment`	Edm.Int16	HTTP Canlı Akışı (HLS) segment başına parça miktarı.

ComplexType Kodlama

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
`AdMarkerSource`	Edm.String	Reklam işaretçileri sinyalleri için kaynağı belirtebilirsiniz. Varsayılan değer, `Api`Kanal içindeki canlı kodlayıcının zaman uyumsuz `Ad Marker API`bir dinlemesi gerektiğini gösterir. Diğer geçerli seçenek ise (`Scte35`yalnızca alma akış protokolü Belirtildiğinde `Scte35` olarak ayarlandığında `RTP (MPEG-TS).` izin verilir), kodlayıcı giriş RTP (MPEG-TS) akışındaki sinyalleri ayrıştıracaktır`SCTE-35`.
`IgnoreCea708ClosedCaptions`	Edm.bool	`Optional`. Canlı kodlayıcıya gelen videoya eklenmiş CEA 708 açıklamalı alt yazı verilerini yoksayması gerektiğini bildiren isteğe bağlı bir bayrak. Bayrak false (varsayılan) olarak ayarlandığında kodlayıcı CEA 708 verilerini algılar ve çıkış video akışlarına yeniden ekler.
`VideoStream`	VideoStream	`Optional`. Giriş video akışını açıklar. Bu alan belirtilmezse varsayılan değer kullanılır. Bu ayara yalnızca giriş akışı protokolü RTP (MPEG-TS) olarak ayarlandığında izin verilir.
`AudioStreams`	AudioStreams	`Optional`. Giriş ses akışlarını açıklar. Bu alan belirtilmezse, belirtilen varsayılan değerler uygulanır. Bu ayara yalnızca giriş akışı protokolü RTP (MPEG-TS) olarak ayarlandığında izin verilir.
`SystemPreset`	Edm.String	Bu Kanal için kullanılacak kodlayıcı ön ayarını belirtir. Şu anda, izin verilen tek değer (varsayılan) değeridir `Default720p` . Daha fazla ayrıntı için bkz . SystemPreset

SystemPreset

Default720p videoyu aşağıdaki 6 katmana kodlamayı belirtir.

Bitrate	Width	Height	MaxFPS	Profil	Çıkış Akışı Adı
3500	1280	720	30	Yüksek	Video_1280x720_3500kbps
2200	960	540	30	Yüksek	Video_960x540_2200kbps
1350	704	396	30	Yüksek	Video_704x396_1350kbps
850	512	288	30	Yüksek	Video_512x288_850kbps
550	384	216	30	Yüksek	Video_384x216_550kbps
200	340	192	30	Yüksek	Video_340x192_200kbps

Ses, 64 kb/sn'de stereo AAC-LC, örnekleme hızı 44,1 kHz olarak kodlanmıştır.

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

VideoStream

Giriş video akışını açıklar. Bu alan belirtilmezse varsayılan değer kullanılır. Bu ayara yalnızca giriş akışı protokolü RTP (MPEG-TS) olarak ayarlandığında izin verilir.

Ad	Tür	Description
`Index`	Edm.Int1	Kanal içindeki canlı kodlayıcı tarafından hangi giriş video akışının işlenmesi gerektiğini belirten sıfır tabanlı bir dizin. Bu ayar yalnızca alma akış protokolü RTP (MPEG-TS) olduğunda geçerlidir. Varsayılan değer sıfırdır. Tek bir program aktarım akışında (SPTS) göndermeniz önerilir. Giriş akışı birden çok program içeriyorsa, canlı kodlayıcı girişteki Program Eşleme Tablosu'nu (PMT) ayrıştırarak MPEG-2 Video veya H.264 akış türüne sahip girişleri tanımlar ve PMT'de belirtilen sırada düzenler. Sıfır tabanlı dizin daha sonra bu düzenlemedeki n. girişi almak için kullanılır.
`Name`	Edm.String	`Optional`. Bu giriş video akışı için açıklayıcı etiket.

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

AudioStreams

Giriş ses akışlarını açıklar. Bu alan belirtilmezse, belirtilen varsayılan değerler uygulanır. Bu ayara yalnızca giriş akışı protokolü RTP (MPEG-TS) olarak ayarlandıysa izin verilir.

Ad	Tür	Description
`Index`	Edm.Int16	Tek bir program aktarım akışında (SPTS) göndermeniz önerilir. Giriş akışı birden çok program içeriyorsa, Kanal içindeki canlı kodlayıcı girişteki Program Eşleme Tablosu'nu (PMT) ayrıştırarak MPEG-2 AAC ADTS veya AC-3 System-A veya AC-3 System-B veya MPEG-2 Özel PES veya MPEG-1 Ses veya MPEG-2 Ses akış türü adına sahip girişleri tanımlar ve PMT'de belirtilen sırada düzenler. Sıfır tabanlı dizin daha sonra bu düzenlemedeki n. girişi almak için kullanılır.
`Name`	Edm.String	`Optional`. Bu giriş ses akışı için açıklayıcı etiket.
`Language`	Edm.String	`Optional`. ENG gibi ISO 639-2'ye uygun ses akışının dil tanımlayıcısı. Yoksa, varsayılan UND 'dir (tanımsız). Kanala giriş RTP üzerinden MPEG-2 TS ise en fazla 8 ses akışı kümesi belirtilebilir. Ancak, aynı Dizin değerine sahip iki giriş olamaz.

Kodlayıcıya giriş RTP üzerinden MPEG-2 TS ise en fazla 8 {Index, Name, Language} kümesi belirtilebilir. Ancak, aynı Dizin değerine sahip iki giriş olamaz. Kodlayıcıya giriş RTMP veya HTTP (Kesintisiz Akış) ise, girişte yalnızca bir ses akışı olabilir.

Kayrak

Bu ayar yalnızca Encoding Type Kanalın değeri olarak ayarlandığında Standarddesteklenir.

Kanal içindeki canlı kodlayıcıya, bir kayrak görüntüsüne geçiş yapmak için sinyal gönderilebilir. Devam eden bir sayfayı sonlandırmak için de işaretlenebilir.

Canlı kodlayıcı, örneğin reklam molası sırasında belirli durumlarda bir kayrak görüntüsüne geçiş yapmak ve gelen video sinyalini maskelemek için yapılandırılabilir. Böyle bir sayfa yapılandırılmamışsa, bu reklam arası sırasında giriş videosu maskelenmez.

Ad	Tür	Description
`InsertSlateOnAdMarker`	Edm.Bool	True olarak ayarlandığında, bu ayar canlı kodlayıcıyı reklam molası sırasında bir sayfa resmi eklemek üzere yapılandırılır. Varsayılan değer true şeklindedir.
`DefaultSlateAssetId`	Edm.String	`Optional`. Media Services Varlığının, sayfa görüntüsünü içeren Varlık Kimliğini belirtir. Varsayılan değer null'dır. Kanal'ı oluşturmadan önce JPEG biçiminde ve en fazla 3 Mbayt boyutunda 1920x1080 maksimum çözünürlüğe sahip olan sayfa görüntüsü ayrılmış varlık olarak yüklenmelidir (bu varlıkta başka hiçbir dosya olmamalıdır). Dosya adının *.jpg uzantısı olmalıdır ve bu AssetFile bu varlığın birincil dosyası olarak işaretlenmelidir. Bu Varlık depolama şifreli olamaz. Varsayılan sayfa Varlık Kimliği belirtilmezse ve reklam işaretçisine sayfa ekle değeri true olarak ayarlanırsa, giriş akışını maskelerken varsayılan bir Azure Media Services görüntüsü kullanılır.

Bu tür ve özellikleri hakkında daha ayrıntılı bilgi için bkz. Live Encoding için etkinleştirilmiş Kanallara Genel Bakış.

Kanal Oluşturma

Kanallar POST HTTP isteği kullanılarak ve özellik değerleri belirterek oluşturulabilir.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Aşağıdaki istek gövdesinde canlı kodlama için etkinleştirilmiş bir kanalın nasıl oluşturulacağı gösterilmektedir.

{  
   "Id":null,  
   "Name":"testchannel001",     
   "Description":"",  
   "EncoderType":"Standard",  
   "Created":"0001-01-01T00:00:00",  
   "LastModified":"0001-01-01T00:00:00",  
   "State":null,  
   "Input":  
   {  
      "StreamingProtocol":"RTPMPEG2TS",  
      "AccessControl":  
      {  
         "IP":  
         {  
         "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   },  
   "Encoding":  
   {  
      "SystemPreset":"Default720p",  
      "IgnoreCea708ClosedCaptions": false,  
      "AdMarkerSource": "Api",
      "VideoStream":  
      {  
         "Index":1,  
         "Name":"Video stream"  
      },  
      "AudioStreams":  
      [  
         {  
            "Index":0,  
            "Name":"English audio stream",  
            "Language":"ENG"  
         },  
         {  
            "Index":1,  
            "Name":"Spanish audio stream",  
            "Language":"SPA"  
         }  
      ]  
   },  
   "EncodingType": "Standard",  
   "Slate":  
   {  
      "InsertOnAdMarker":true,  
      "DefaultSlateAssetId": "nb:cid:UUID:01234567-0123-0123-0123-01234567"  
   },  
   "Preview":  
   {  
      "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   }  
}

Aşağıdaki istek gövdesi, hesapta canlı kodlama için etkinleştirilmemiş bir kanalın nasıl oluşturulacağını gösterir.

{  
"Id":null,  
"Name":"testchannel001",  
"Description":"",  
"Created":"0001-01-01T00:00:00",  
"LastModified":"0001-01-01T00:00:00",  
"State":null,  
"Input":  
   {  
   "KeyFrameInterval":null,  
   "StreamingProtocol":"FragmentedMP4",  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
   "Endpoints":[]  
   },  
"Preview":  
   {  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
      "Endpoints":[]  
   },  
"Output":  
   {  
   "Hls":  
      {  
         "FragmentsPerSegment":1  
      }  
   },  
"CrossSiteAccessPolicies":  
   {  
      "ClientAccessPolicy":null,  
      "CrossDomainPolicy":null  
   }  
}

Başarılı olursa, yanıt gövdesinde oluşturulan varlığın gösterimiyle birlikte 202 Kabul Edildi durum kodu döndürülür.

202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir; bu durumda operation-id üst bilgi değeri, kanalı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.

Kanalları Başlat

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Start	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Start HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Başarılı olursa , 202 Kabul edildi durum kodu döndürülür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir; bu durumda operation-id üst bilgi değeri, kanalı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.

Kanalları Durdur

Kanal yalnızca Çalışıyor durumundayken durdurulabilir ve kanaldaki tüm programlar durdurulur.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Stop	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Stop HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Kanalları Listele

Kanallar GET HTTP isteği kullanılarak alınabilir.

Yöntem	İstek URI'si	HTTP Sürümü
GET	Tüm Kanalları Al: <https:// accountname.restv2>.<location.media.azure.net/api/Channels> Belirtilen kanalı alın. <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

GET https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Başarılı olursa, bu işlem 200 Tamam durum kodunu ve Media Services hesabınızda oluşturulan tüm Kanalların listesini döndürür.

Kanalları Sıfırla

Canlı bir sununun akışı boyunca tutulan çalışma zamanı Kanal durumunu sıfırlar ve sununun sıfırlanması veya kodlayıcının yeniden yapılandırılması durumunda Kanalın yeniden kullanılmasına olanak tanır. Sıfırla'yı çağırmadan önce tüm Programları durdurun. Sıfırlama, çalışma durumundaki bir Kanalda çağrılabilir.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Reset	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Reset HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Kanalları Güncelleştirme

Mevcut kanalda özellikleri Güncelleştirmeler. Kanal Durduruldu durumunda olmalıdır.

Yöntem	İstek URI'si	HTTP Sürümü
PATCH/PUT/MERGE Bu işlemler hakkında daha fazla bilgi için bkz. PATCH/PUT/MERGE.	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

PATCH https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

İstek gövdesi:

"Encoding":{"IgnoreCea708ClosedCaptions": true}

Güncelleştirme zaman uyumlu olarak tamamlanırsa , 204 İçerik Yok durum kodunu döndürür; aksi takdirde 202 Kabul Edildi durum kodunu döndürür. 202 Kabul Edildi durum kodu zaman uyumsuz bir işlemi gösterir; bu durumda operation-id üst bilgi değeri, kanalı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile yoklama Long-Running İşlemler.

Tanıtımı Başlat

Canlı kodlayıcıya POST HTTP isteği kullanarak bir tanıtım veya ticari kesme başlatması ve isteğin gövdesindeki StartAdvertisement Varlığı varlığında öğesinin özellik değerlerini belirtmesi için sinyal gönderilebilir.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/StartAdvertisement	HTTP/1.1

Daha fazla bilgi için bkz. Live Encoding için etkinleştirilmiş Kanallara Genel Bakış.

StartAdvertisement Varlığı

Bu varlık, tanıtım başlangıcı API'sini temsil eder; çıkış akışına bir tanıtım veya ticari kesme eklemek için canlı kodlayıcıya zaman uyumsuz bir çağrıdır.

Daha fazla bilgi için bkz. Live Encoding için etkinleştirilmiş Kanallara Genel Bakış.

Ad	Tür	Description
`duration`	Edm.Duration	Ticari molanın süresi (saniye cinsinden). Bu, ticari molayı başlatmak için sıfır olmayan pozitif bir değer olmalıdır. Bir ticari kesme işlemi devam ettiğinde ve süre cueid değeri devam eden ticari kesmeyle eşleşecek şekilde sıfır olarak ayarlandığında, bu kesme iptal edilir.
`cueId`	Edm.Int	Aşağı akış uygulaması tarafından uygun eylemleri yapmak için kullanılacak ticari sonun benzersiz kimliği. Pozitif bir tamsayı olmalıdır.
`showSlate`	Edm.Bool	`Optional`. Kanal içindeki canlı kodlayıcıya, ticari mola sırasında varsayılan sayfa görüntüsüne geçmesi gerektiğini gösterir (ve gelen video akışını maskeler). Varsayılan değer false’tur. Kullanılan görüntü, kanal oluşturma sırasında varsayılan kayrak varlık kimliği özelliği aracılığıyla belirtilen görüntü olacaktır.

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/StartAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Gövde

{  
   "duration":"PT45S",  
   "cueId":"67520935",  
   "showSlate":"true"  
}

Başarılı olursa , 202 Kabul edildi durum kodu döndürülür.

Tanıtımı Sonlandır

Canlı kodlayıcıya POST HTTP isteği kullanarak devam eden bir reklamı veya ticari molayı sonlandırması için sinyal gönderilebilir.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/EndAdvertisement	HTTP/1.1

Bu çağrı yalnızca devam eden bir reklam olduğunda çağrılmalıdır.

Daha fazla bilgi için bkz. Live Encoding için etkinleştirilmiş Kanallara Genel Bakış.

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/EndAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Başarılı olursa , 202 Kabul edildi durum kodu döndürülür.

Sayfayı Göster

Kanal içindeki canlı kodlayıcıya, ticari mola sırasında varsayılan sayfa görüntüsüne geçmesi gerektiğini gösterir (ve gelen video akışını maskeler). Varsayılan değer false’tur. Kullanılan görüntü, kanal oluşturma sırasında varsayılan kayrak varlık kimliği özelliği aracılığıyla belirtilen görüntü olacaktır.

HTTP isteğinin gövdesinde ShowSlate Varlığının özelliklerini kullanın.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/ShowSlate	HTTP/1.1

Daha fazla bilgi için bkz. Live Encoding için etkinleştirilmiş Kanallara Genel Bakış.

ShowSlate Varlığı

Daha fazla bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Ad	Tür	Description
`duration`	Edm.Duration	Sayfayı saniye cinsinden süresi. Bu, sayfayı başlatmak için sıfır olmayan pozitif bir değer olmalıdır. Devam eden bir sayfa varsa ve sıfır süresi belirtilirse, devam eden sayfa sonlandırılır.
`assetId`	Edm.String	Media Services Varlığının, kayrak görüntüsünü içeren Varlık Kimliğini belirtir. Kanalı oluşturmadan önce JPEG biçiminde ve en fazla 3 Mb boyutunda 1920x1080 çözünürlüğündeki kayrak görüntüsü ayrılmış Varlık olarak karşıya yüklenmelidir (bu Varlıkta başka hiçbir dosya olmamalıdır). Kodlayıcıya herhangi bir rastgele kayrak görüntüsüne (Kanalı oluştururken yalnızca DefaultSlateAssetId özelliğiyle belirtilen görüntüye değil) geçmesi için sinyal gönderilebilir.

DefaultSlateAssetId Özellik belirtilirse ve AssetId belirtilmezseDefaultSlateAssetId, giriş akışını maske etmek için görüntü kullanılır. Daha fazla bilgi için bkz . Slate.

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/ShowSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Gövde

{  
   "duration":"PT45S",  
   "assetId":"nb:cid:UUID:01234567-ABCD-ABCD-EFEF-01234567"  
}

Başarılı olursa , 202 Kabul edildi durum kodu döndürülür.

Sayfayı Gizle

Canlı kodlayıcıya POST HTTP isteği kullanarak devam eden bir sayfayı sonlandırması için sinyal gönderilebilir.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/HideSlate	HTTP/1.1

Bu çağrı yalnızca devam eden bir sayfa olduğunda çağrılmalıdır.

Daha fazla bilgi için bkz. Canlı Kodlama için etkinleştirilen Kanallara Genel Bakış.

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/HideSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Başarılı olursa , 202 Kabul edildi durum kodu döndürülür. 202 Kabul edildi durum kodu zaman uyumsuz bir işlemi gösterir. Bu durumda operation-id üst bilgi değeri, kanalı başlatma veya durdurma gibi uzun süre çalışan işlemlerin durumunu yoklama ve izleme amacıyla da sağlanır. Durumu almak için operation-id üst bilgi değerini İşlem Varlığı'na geçirin. Daha fazla bilgi için bkz. el ile Yoklama Long-Running İşlemler.

Kanalları Sil

Kanalı silme.

Yöntem	İstek URI'si	HTTP Sürümü
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

DELETE https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Ayrıca Bkz.

Azure Media Services ile Canlı Akış Sağlama
Program

Kanal

Kanal Varlığı

ChannelInput ComplexType

ChannelPreview ComplexType

ChannelInputAccessControl ComplexType

ChannelPreviewAccessControl ComplexType

IPAccessControl

IPRange ComplexType

ChannelEndpoint ComplexType

ChannelOutput ComplexType

ChannelOutputHls ComplexType

ComplexType Kodlama

SystemPreset

VideoStream

AudioStreams

Kayrak

Kanal Oluşturma

Örnek İstek

Kanalları Başlat

Örnek İstek

Kanalları Durdur

Örnek İstek

Kanalları Listele

Örnek İstek

Kanalları Sıfırla

Örnek İstek

Kanalları Güncelleştirme

Örnek İstek

Tanıtımı Başlat

StartAdvertisement Varlığı

Örnek İstek

Tanıtımı Sonlandır

Örnek İstek

Sayfayı Göster

ShowSlate Varlığı

Örnek İstek

Sayfayı Gizle

Örnek İstek

Kanalları Sil

Örnek İstek

Ayrıca Bkz.

Ek kaynaklar