Share via

Live Events - Create

  • Başvuru
Service:
Media Services
API Version:
2022-11-01

Canlı Etkinlik Oluşturma
Yeni bir canlı etkinlik oluşturur.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01
With optional parameters: 
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01&autoStart={autoStart}

URI Parametreleri

Name İçinde Gerekli Tür Description
accountName
 path True

string

Media Services hesap adı.
liveEventName
 path True

string

Canlı etkinliğin adı, maksimum uzunluk 32'dir.

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
resourceGroupName
 path True

string

Azure aboneliğindeki kaynak grubunun adı.
subscriptionId
 path True

string

Microsoft Azure aboneliğinin benzersiz tanımlayıcısı.
api-version
 query True

string

İstemci isteğiyle kullanılacak API'nin sürümü.
autoStart
 query

boolean

bayrağı, kaynağın oluşturma işleminde otomatik olarak başlatılması gerekip gerekmediğini gösterir.

İstek Gövdesi

Name Gerekli Tür Description
location True

string

Kaynağın bulunduğu coğrafi konum
properties.input True

LiveEventInput

Canlı etkinlik giriş ayarları. Canlı etkinliğin bir katkı kodlayıcıdan nasıl giriş alacağını tanımlar.
properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Canlı etkinlik siteler arası erişim ilkeleri.
properties.description

string

Canlı etkinlik için bir açıklama.
properties.encoding

LiveEventEncoding

Canlı etkinlik için kodlama ayarları. Canlı etkinlik için canlı kodlayıcının kullanılıp kullanılmayacağını ve kullanıldıysa canlı kodlayıcı ayarlarını yapılandırılır.
properties.hostnamePrefix

string

useStaticHostname true olarak ayarlandığında, hostnamePrefix canlı olay önizlemesi ve alma uç noktalarına atanan konak adının ilk bölümünü belirtir. Son ana bilgisayar adı bu ön ekin, medya hizmeti hesap adının ve Azure Media Services veri merkezi için kısa bir kodun birleşimi olacaktır.
properties.preview

LiveEventPreview

Canlı etkinlik önizleme ayarları. Önizleme, canlı etkinlik yapımcılarının canlı çıkış oluşturmadan canlı akış içeriğini önizlemesine olanak tanır.
properties.streamOptions

StreamOptionsFlag[]

LiveEvent için kullanılacak seçenekler. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez. Dizi giriş değerleri için geçerli değerler 'Default' ve 'LowLatency' değerleridir.
properties.transcriptions

LiveEventTranscription[]

Canlı etkinlik için canlı transkripsiyon ayarları. Canlı transkripsiyon özelliği hakkında daha fazla bilgi için bkz https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname

boolean

Statik bir konak adının canlı etkinlik önizlemesine atanıp atanmayacağını ve uç noktaları alıp almayacağını belirtir. Bu değer yalnızca canlı etkinlik Bekleme durumundaysa güncelleştirilebilir
tags

object

Kaynak etiketleri.

Yanıtlar

Name Tür Description
200 OK

LiveEvent

Tamam ögesini seçin. İstek başarılı oldu.
201 Created

LiveEvent

Oluşturulan. İstek işlenmek üzere kabul edildi ve işlem zaman uyumsuz olarak tamamlanacak. Azure-AsyncOperation yanıt üst bilgisini kullanarak zaman uyumsuz Azure işlemlerini izleme hakkında ayrıntılı bilgi için bkz https://go.microsoft.com/fwlink/?linkid=2087017 .
Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan akış hatası yanıtı.

Örnekler

Create a LiveEvent

Sample Request

PUT https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "input": {
      "streamingProtocol": "RTMP",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    }
  }
}

Sample Response

Status code:
201 
azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
Response Body
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "resourceState": "Creating",
    "provisioningState": "InProgress",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}
Status code:
200 
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}

Tanımlar

Name Description
createdByType

Kaynağı oluşturan kimliğin türü.
CrossSiteAccessPolicies

İstemci erişim ilkesi.
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
ErrorDetail

Hata ayrıntısı.
ErrorResponse

Hata yanıtı
IPAccessControl

IP erişim denetimi.
IPRange

CIDR düzenindeki IP adresi aralığı.
LiveEvent

Canlı etkinlik.
LiveEventEncoding

Canlı olayları kodlamak için canlı olay türünü ve isteğe bağlı kodlama ayarlarını belirtir.
LiveEventEncodingType

Canlı etkinlik türü. encodingType, PassthroughBasic veya PassthroughStandard olarak ayarlandığında, hizmet yalnızca gelen video ve ses katmanlarından çıkışa geçer. encodingType Standart veya Premium1080p olarak ayarlandığında, canlı kodlayıcı gelen akışı birden çok bit hızına veya katmana dönüştürür. Daha fazla bilgi edinmek için bkz. https://go.microsoft.com/fwlink/?linkid=2095101. Canlı etkinlik oluşturulduktan sonra bu özellik değiştirilemez.
LiveEventEndpoint

Canlı olay uç noktası.
LiveEventInput

Canlı etkinlik girişi.
LiveEventInputAccessControl

Canlı olay girişi için IP erişim denetimi.
LiveEventInputProtocol

Canlı etkinlik için giriş protokolü. Bu, oluşturma zamanında belirtilir ve güncelleştirilemez.
LiveEventInputTrackSelection

Seçim durumunu izleme. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.
LiveEventOutputTranscriptionTrack

Konuşmayı metne dönüştürme transkripsiyonu kullanılarak oluşturulan canlı etkinliğin çıkışındaki transkripsiyon izlemesini açıklar. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.
LiveEventPreview

Canlı etkinlik önizleme ayarları.
LiveEventPreviewAccessControl

Canlı olay önizleme uç noktası için IP erişim denetimi.
LiveEventResourceState

Canlı etkinliğin kaynak durumu. Daha fazla bilgi edinmek için bkz. https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint

Canlı olay meta veri ekleme uç noktası.
LiveEventTranscription

Konuşmayı metne dönüştürme transkripsiyonu kullanılarak oluşturulan canlı etkinliğin çıkışındaki transkripsiyon izlerini açıklar. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.
StreamOptionsFlag

LiveEvent için kullanılacak seçenekler. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez. Dizi giriş değerleri için geçerli değerler 'Default' ve 'LowLatency' değerleridir.
StretchMode

Giriş videosunun istenen çıkış çözünürlüklerine uyacak şekilde nasıl yeniden boyutlandırılacağını belirtir. Varsayılan değer Yok'tur
systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

İstemci erişim ilkesi.

Name Tür Description
clientAccessPolicy

string

Silverlight tarafından kullanılan clientaccesspolicy.xml içeriği.
crossDomainPolicy

string

Silverlight tarafından kullanılan crossdomain.xml içeriği.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

ErrorDetail[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

IPAccessControl

IP erişim denetimi.

Name Tür Description
allow

IPRange[]

IP izin verme listesi.

IPRange

CIDR düzenindeki IP adresi aralığı.

Name Tür Description
address

string

IP adresi.
name

string

IP adresi aralığının kolay adı.
subnetPrefixLength

integer

Alt ağ maskesi ön ek uzunluğu (bkz. CIDR gösterimi).

LiveEvent

Canlı etkinlik.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Kaynağın bulunduğu coğrafi konum
name

string

Kaynağın adı
properties.created

string

Canlı etkinlik için oluşturma zamanı
properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Canlı etkinlik siteler arası erişim ilkeleri.
properties.description

string

Canlı etkinlik için bir açıklama.
properties.encoding

LiveEventEncoding

Canlı etkinlik için kodlama ayarları. Canlı etkinlik için canlı kodlayıcının kullanılıp kullanılmayacağını ve kullanıldıysa canlı kodlayıcı ayarlarını yapılandırılır.
properties.hostnamePrefix

string

useStaticHostname true olarak ayarlandığında, hostnamePrefix canlı olay önizlemesi ve alma uç noktalarına atanan konak adının ilk bölümünü belirtir. Son ana bilgisayar adı bu ön ekin, medya hizmeti hesap adının ve Azure Media Services veri merkezi için kısa bir kodun birleşimi olacaktır.
properties.input

LiveEventInput

Canlı etkinlik giriş ayarları. Canlı etkinliğin bir katkı kodlayıcıdan nasıl giriş alacağını tanımlar.
properties.lastModified

string

Canlı etkinliğin son değiştirme zamanı.
properties.preview

LiveEventPreview

Canlı etkinlik önizleme ayarları. Önizleme, canlı etkinlik yapımcılarının canlı çıkış oluşturmadan canlı akış içeriğini önizlemesine olanak tanır.
properties.provisioningState

string

Canlı etkinliğin sağlama durumu.
properties.resourceState

LiveEventResourceState

Canlı etkinliğin kaynak durumu. Daha fazla bilgi edinmek için bkz. https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions

StreamOptionsFlag[]

LiveEvent için kullanılacak seçenekler. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez. Dizi giriş değerleri için geçerli değerler 'Default' ve 'LowLatency' değerleridir.
properties.transcriptions

LiveEventTranscription[]

Canlı etkinlik için canlı transkripsiyon ayarları. Canlı transkripsiyon özelliği hakkında daha fazla bilgi için bkz https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname

boolean

Statik bir konak adının canlı etkinlik önizlemesine atanıp atanmayacağını ve uç noktaları alıp almayacağını belirtir. Bu değer yalnızca canlı etkinlik Bekleme durumundaysa güncelleştirilebilir
systemData

systemData

Bu kaynakla ilgili sistem meta verileri.
tags

object

Kaynak etiketleri.
type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Canlı olayları kodlamak için canlı olay türünü ve isteğe bağlı kodlama ayarlarını belirtir.

Name Tür Description
encodingType

LiveEventEncodingType

Canlı etkinlik türü. encodingType, PassthroughBasic veya PassthroughStandard olarak ayarlandığında, hizmet yalnızca gelen video ve ses katmanlarından çıkışa geçer. encodingType Standart veya Premium1080p olarak ayarlandığında, canlı kodlayıcı gelen akışı birden çok bit hızına veya katmana dönüştürür. Daha fazla bilgi edinmek için bkz. https://go.microsoft.com/fwlink/?linkid=2095101. Canlı etkinlik oluşturulduktan sonra bu özellik değiştirilemez.
keyFrameInterval

string

Bir kodlama canlı olayının video ve ses parçalarının çıkış parçası uzunluğunu belirtmek için 0,5 ila 20 saniye arasında bir ISO 8601 zaman değeri kullanın. Örneğin, 2 saniyeyi belirtmek için PT2S kullanın. Video izlemesi için anahtar kare aralığını veya GoP uzunluğunu (resim grubu) da tanımlar. Bu değer bir kodlama canlı olayı için ayarlanmadıysa, parça süresi varsayılan olarak 2 saniyedir. Doğrudan canlı etkinlikler için değer ayarlanamaz.
presetName

string

encodingType Yok olmadığında kullanılan isteğe bağlı kodlama önayar adı. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez. encodingType Standart olarak ayarlanırsa, varsayılan ön ayar adı 'Default720p' olur. Aksi takdirde encodingType Premium1080p olarak ayarlanırsa varsayılan ön ayar 'Default1080p' olur.
stretchMode

StretchMode

Giriş videosunun istenen çıkış çözünürlüklerine uyacak şekilde nasıl yeniden boyutlandırılacağını belirtir. Varsayılan değer Yok'tur

LiveEventEncodingType

Canlı etkinlik türü. encodingType, PassthroughBasic veya PassthroughStandard olarak ayarlandığında, hizmet yalnızca gelen video ve ses katmanlarından çıkışa geçer. encodingType Standart veya Premium1080p olarak ayarlandığında, canlı kodlayıcı gelen akışı birden çok bit hızına veya katmana dönüştürür. Daha fazla bilgi edinmek için bkz. https://go.microsoft.com/fwlink/?linkid=2095101. Canlı etkinlik oluşturulduktan sonra bu özellik değiştirilemez.

Name Tür Description
None

string

Bu, PassthroughStandard ile aynıdır, lütfen aşağıdaki açıklamaya bakın. Bu numaralandırma değeri kullanım dışı bırakılıyor.
PassthroughBasic

string

Alınan akış, daha fazla işlem yapmadan katkı kodlayıcısından canlı etkinlikten geçer. PassthroughBasic modunda alım 5 Mb/sn'ye kadar sınırlıdır ve yalnızca 1 eşzamanlı canlı çıkışa izin verilir. Canlı transkripsiyon kullanılamaz.
PassthroughStandard

string

Alınan akış, daha fazla işlem yapmadan katkı kodlayıcısından canlı etkinlikten geçer. Canlı transkripsiyon kullanılabilir. Alım bit hızı sınırları çok daha yüksektir ve 3'e kadar eşzamanlı canlı çıkışa izin verilir.
Premium1080p

string

Bir katkı canlı kodlayıcısı canlı etkinliğe tek bir bit hızı akışı gönderir ve Media Services birden çok bit hızı akışı oluşturur. Çıkış çözünürlükte 1080p'yi aşamaz.
Standard

string

Bir katkı canlı kodlayıcısı canlı etkinliğe tek bir bit hızı akışı gönderir ve Media Services birden çok bit hızı akışı oluşturur. Çıkış çözünürlükte 720p'yi aşamaz.

LiveEventEndpoint

Canlı olay uç noktası.

Name Tür Description
protocol

string

Uç nokta protokolü.
url

string

Uç nokta URL'si.

LiveEventInput

Canlı etkinlik girişi.

Name Tür Description
accessControl

LiveEventInputAccessControl

Canlı etkinlik girişi için erişim denetimi.
accessToken

string

Akışı benzersiz olarak tanımlamak için dize biçiminde bir UUID. Bu, oluşturma zamanında belirtilebilir ancak güncelleştirilemez. Atlanırsa, hizmet benzersiz bir değer oluşturur.
endpoints

LiveEventEndpoint[]

Canlı olayın giriş uç noktaları.
keyFrameIntervalDuration

string

Girişin anahtar kare aralığı süresinin ISO 8601 süresi. Bu değer HLS çıkışında EXT-X-TARGETDURATION özelliğini ayarlar. Örneğin, 2 saniyeyi belirtmek için PT2S kullanın. Canlı olayları kodlamak için değeri boş bırakın.
streamingProtocol

LiveEventInputProtocol

Canlı etkinlik için giriş protokolü. Bu, oluşturma zamanında belirtilir ve güncelleştirilemez.
timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

Canlı olayın meta veri uç noktaları.

LiveEventInputAccessControl

Canlı olay girişi için IP erişim denetimi.

Name Tür Description
ip

IPAccessControl

IP erişim denetimi özellikleri.

LiveEventInputProtocol

Canlı etkinlik için giriş protokolü. Bu, oluşturma zamanında belirtilir ve güncelleştirilemez.

Name Tür Description
FragmentedMP4

string

Kesintisiz Akış girişi, canlı etkinliğe katkı kodlayıcısı tarafından gönderilir.
RTMP

string

RTMP girişi, canlı etkinliğe katkı kodlayıcısı tarafından gönderilir.

LiveEventInputTrackSelection

Seçim durumunu izleme. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.

Name Tür Description
operation

string

İşlem karşılaştırıyor. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.
property

string

Seçecek özellik adı. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.
value

string

Seçecek özellik değeri. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.

LiveEventOutputTranscriptionTrack

Konuşmayı metne dönüştürme transkripsiyonu kullanılarak oluşturulan canlı etkinliğin çıkışındaki transkripsiyon izlemesini açıklar. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.

Name Tür Description
trackName

string

Çıkış parçası adı. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.

LiveEventPreview

Canlı etkinlik önizleme ayarları.

Name Tür Description
accessControl

LiveEventPreviewAccessControl

Canlı etkinlik önizlemesi için erişim denetimi.
alternativeMediaId

string

Önizleme için oluşturulan akış bulucu ile ilişkili alternatif bir medya tanımlayıcısı. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez. Tanımlayıcı, StreamingPolicyName alanında belirtilen StreamingPolicy'nin CustomLicenseAcquisitionUrlTemplate veya CustomKeyAcquisitionUrlTemplate içinde kullanılabilir.
endpoints

LiveEventEndpoint[]

Önizleme uç noktaları. Önizleme URL'sini canlı etkinlik izleyicileriyle paylaşmayın.
previewLocator

string

Önizleme bulucunun Guid biçimindeki tanımlayıcısı. Bunu oluşturma zamanında belirtmek, çağıranın olay oluşturulmadan önce önizleme bulucu URL'sini bilmesini sağlar. Atlanırsa, hizmet rastgele bir tanımlayıcı oluşturur. Canlı etkinlik oluşturulduktan sonra bu değer güncelleştirilemez.
streamingPolicyName

string

Canlı etkinlik önizlemesi için kullanılan akış ilkesinin adı. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez.

LiveEventPreviewAccessControl

Canlı olay önizleme uç noktası için IP erişim denetimi.

Name Tür Description
ip

IPAccessControl

IP erişim denetimi özellikleri.

LiveEventResourceState

Canlı etkinliğin kaynak durumu. Daha fazla bilgi edinmek için bkz. https://go.microsoft.com/fwlink/?linkid=2139012.

Name Tür Description
Allocating

string

Canlı etkinlikte Ayırma eylemi çağrıldı ve bu canlı etkinlik için kaynaklar sağlanıyor. Ayırma başarıyla tamamlandıktan sonra canlı olay Bekleme durumuna geçirilir.
Deleting

string

Canlı etkinlik siliniyor. Bu geçici durumda faturalama gerçekleşmez. Bu durum sırasında Güncelleştirmeler veya akışa izin verilmez.
Running

string

Canlı etkinlik kaynakları ayrılmış, alma ve önizleme URL'leri oluşturulmuştur ve canlı akışlar alabilir. Bu noktada faturalama etkindir. Daha fazla faturalamayı durdurmak için canlı etkinlik kaynağında Dur'u açıkça çağırmanız gerekir.
StandBy

string

Canlı etkinlik kaynakları sağlanmıştır ve başlamaya hazırdır. Faturalama bu durumda gerçekleşir. Özelliklerin çoğu yine güncelleştirilebilir, ancak bu durum sırasında alma veya akışa izin verilmez.
Starting

string

Canlı etkinlik başlatılıyor ve kaynaklar ayrılıyor. Bu durumda faturalama gerçekleşmez. Bu durum sırasında Güncelleştirmeler veya akışa izin verilmez. Hata oluşursa canlı olay Durduruldu durumuna döner.
Stopped

string

Bu, oluşturulduktan sonra canlı etkinliğin ilk durumudur (otomatik başlangıç true olarak ayarlanmadıysa).) Bu durumda faturalama gerçekleşmez. Bu durumda canlı etkinlik özellikleri güncelleştirilebilir ancak akışa izin verilmez.
Stopping

string

Canlı etkinlik durduruluyor ve kaynakların sağlaması kaldırılıyor. Bu geçici durumda faturalama gerçekleşmez. Bu durum sırasında Güncelleştirmeler veya akışa izin verilmez.

LiveEventTimedMetadataEndpoint

Canlı olay meta veri ekleme uç noktası.

Name Tür Description
url

string

Meta veri uç noktası URL'si.

LiveEventTranscription

Konuşmayı metne dönüştürme transkripsiyonu kullanılarak oluşturulan canlı etkinliğin çıkışındaki transkripsiyon izlerini açıklar. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.

Name Tür Description
inputTrackSelection

LiveEventInputTrackSelection[]

Konuşmadan metne transkripsiyonun uygulandığı giriş canlı akışında ses parçasını seçme mekanizması sağlar. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.
language

string

Konuşmayı metne dönüştürme transkripsiyonu için kullanılacak dili (yerel ayar) belirtir; ses parçasındaki konuşulan dille eşleşmelidir. Değer BCP-47 biçiminde olmalıdır (örneğin: 'tr-TR'). Canlı transkripsiyon özelliği ve desteklenen dillerin listesi hakkında daha fazla bilgi için bkz https://go.microsoft.com/fwlink/?linkid=2133742 .
outputTranscriptionTrack

LiveEventOutputTranscriptionTrack

Konuşmayı metne dönüştürme transkripsiyonu kullanılarak oluşturulan canlı etkinliğin çıkışındaki transkripsiyon izlemesini açıklar. Bu özellik gelecekte kullanılmak üzere ayrılmıştır, bu özellikte ayarlanan tüm değerler yoksayılır.

StreamOptionsFlag

LiveEvent için kullanılacak seçenekler. Bu değer oluşturma zamanında belirtilir ve güncelleştirilemez. Dizi giriş değerleri için geçerli değerler 'Default' ve 'LowLatency' değerleridir.

Name Tür Description
Default

string

Özel gecikme süresi iyileştirmeleri olmadan canlı akış.
LowLatency

string

Canlı etkinlik, iç arabelleklerini azaltarak uçtan uca daha düşük gecikme süresi sağlar.
LowLatencyV2

string

Canlı etkinlik uçtan uca gecikme süresi için iyileştirilmiştir. Bu seçenek yalnızca RTMP girişiyle canlı olayları kodlamak için kullanılabilir. Çıkışlar HLS veya DASH biçimleri kullanılarak akışla aktarılabilir. Çıkışların arşiv veya DVR geri sarma uzunluğu 6 saatle sınırlıdır. Diğer tüm senaryolar için "LowLatency" akış seçeneğini kullanın.

StretchMode

Giriş videosunun istenen çıkış çözünürlüklerine uyacak şekilde nasıl yeniden boyutlandırılacağını belirtir. Varsayılan değer Yok'tur

Name Tür Description
AutoFit

string

Çıkış çözünürlüğüne uyması için çıkışı (letterbox veya sütun kutusuyla) sabitlerken, çıkıştaki etkin video bölgesinin girişle aynı en boy oranına sahip olduğundan emin olun. Örneğin, giriş 1920x1080 ise ve kodlama ön ayarı 1280x1280 isterse, çıkış 1280x1280'de olur ve bu da 16:9 en boy oranında 1280x720 iç dikdörtgeni ve sol ve sağda 280 piksel genişliğinde sütun kutusu bölgeleri içerir.
AutoSize

string

Çıkış çözünürlüğünü geçersiz kılın ve doldurma olmadan girişin görüntü en boy oranıyla eşleşecek şekilde değiştirin. Örneğin, giriş 1920x1080 ise ve kodlama ön ayarı 1280x1280 isterse, ön ayardaki değer geçersiz kılınır ve çıkış 16:9 giriş en boy oranını koruyan 1280x720'de olur.
None

string

Giriş videosunun piksel en boy oranını veya görüntü en boy oranını dikkate almadan kodlama ön ayarında belirtilen çıkış çözünürlüğüne kesinlikle saygı gösterir.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.
createdBy

string

Kaynağı oluşturan kimlik.
createdByType

createdByType

Kaynağı oluşturan kimliğin türü.
lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy

string

Kaynağı son değiştiren kimlik.
lastModifiedByType

createdByType

Kaynağı en son değiştiren kimliğin türü.