Live Events - Create

Service:

Media Services

API Version:

2022-11-01

Buat Acara Langsung
Membuat acara langsung baru.

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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
accountName	path	True	string	Nama akun Media Services.
liveEventName	path	True	string	Nama acara langsung, panjang maksimum adalah 32. Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
resourceGroupName	path	True	string	Nama grup sumber daya dalam langganan Azure.
subscriptionId	path	True	string	Pengidentifikasi unik untuk langganan Microsoft Azure.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien.
autoStart	query		boolean	Bendera menunjukkan apakah sumber daya harus dimulai secara otomatis saat pembuatan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi geografis tempat sumber daya berada
properties.input	True	LiveEventInput	Pengaturan input acara langsung. Ini menentukan bagaimana acara langsung menerima input dari encoder kontribusi.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Kebijakan akses lintas situs acara langsung.
properties.description		string	Deskripsi untuk acara langsung.
properties.encoding		LiveEventEncoding	Pengaturan pengodean untuk acara langsung. Ini mengonfigurasi apakah encoder langsung digunakan untuk acara langsung dan pengaturan untuk encoder langsung jika digunakan.
properties.hostnamePrefix		string	Ketika useStaticHostname diatur ke true, hostnamePrefix menentukan bagian pertama dari nama host yang ditetapkan ke pratinjau acara langsung dan menyerap titik akhir. Nama host akhir akan menjadi kombinasi dari awalan ini, nama akun layanan media dan kode pendek untuk pusat data Azure Media Services.
properties.preview		LiveEventPreview	Pengaturan pratinjau acara langsung. Pratinjau memungkinkan produsen acara langsung untuk mempratinjau konten streaming langsung tanpa membuat output langsung apa pun.
properties.streamOptions		StreamOptionsFlag[]	Opsi yang digunakan untuk LiveEvent. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui. Nilai yang valid untuk nilai entri array adalah 'Default' dan 'LowLatency'.
properties.transcriptions		LiveEventTranscription[]	Pengaturan transkripsi langsung untuk acara langsung. Lihat https://go.microsoft.com/fwlink/?linkid=2133742 untuk informasi selengkapnya tentang fitur transkripsi langsung.
properties.useStaticHostname		boolean	Menentukan apakah nama host statis akan ditetapkan ke pratinjau acara langsung dan menyerap titik akhir. Nilai ini hanya dapat diperbarui jika acara langsung dalam status Siaga
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	LiveEvent	OK. Permintaan telah berhasil.
201 Created	LiveEvent	Dibuat. Permintaan telah diterima untuk diproses dan operasi akan selesai secara asinkron. Lihat https://go.microsoft.com/fwlink/?linkid=2087017 untuk detail tentang memantau operasi Azure asinkron menggunakan header respons Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Respons kesalahan streaming yang menjelaskan mengapa operasi gagal.

Contoh

Create a LiveEvent

Sample Request

HTTP

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
            }
          ]
        }
      }
    }
  }
}

Java

import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.LiveEventInput;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputAccessControl;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputProtocol;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreview;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreviewAccessControl;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/** Samples for LiveEvents Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-create.json
     */
    /**
     * Sample code: Create a LiveEvent.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .define("myLiveEvent1")
            .withRegion("West US")
            .withExistingMediaservice("mediaresources", "slitestmedia10")
            .withTags(mapOf("tag1", "value1", "tag2", "value2"))
            .withDescription("test event 1")
            .withInput(
                new LiveEventInput()
                    .withStreamingProtocol(LiveEventInputProtocol.RTMP)
                    .withAccessControl(
                        new LiveEventInputAccessControl()
                            .withIp(
                                new IpAccessControl()
                                    .withAllow(
                                        Arrays
                                            .asList(
                                                new IpRange()
                                                    .withName("AllowAll")
                                                    .withAddress("0.0.0.0")
                                                    .withSubnetPrefixLength(0)))))
                    .withKeyFrameIntervalDuration("fakeTokenPlaceholder"))
            .withPreview(
                new LiveEventPreview()
                    .withAccessControl(
                        new LiveEventPreviewAccessControl()
                            .withIp(
                                new IpAccessControl()
                                    .withAllow(
                                        Arrays
                                            .asList(
                                                new IpRange()
                                                    .withName("AllowAll")
                                                    .withAddress("0.0.0.0")
                                                    .withSubnetPrefixLength(0))))))
            .create();
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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
    }
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
CrossSiteAccessPolicies	Kebijakan akses klien.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
IPAccessControl	Kontrol akses IP.
IPRange	Rentang alamat IP dalam skema CIDR.
LiveEvent	Acara langsung.
LiveEventEncoding	Menentukan jenis acara langsung dan pengaturan pengodean opsional untuk pengodean acara langsung.
LiveEventEncodingType	Jenis acara langsung. Saat encodingType diatur ke PassthroughBasic atau PassthroughStandard, layanan hanya melewati lapisan video dan audio yang masuk ke output. Saat encodingType diatur ke Standar atau Premium1080p, encoder langsung mentranskode aliran masuk ke beberapa laju bit atau lapisan. Lihat https://go.microsoft.com/fwlink/?linkid=2095101 untuk informasi lebih lanjut. Properti ini tidak dapat diubah setelah acara langsung dibuat.
LiveEventEndpoint	Titik akhir acara langsung.
LiveEventInput	Input acara langsung.
LiveEventInputAccessControl	Kontrol akses IP untuk input acara langsung.
LiveEventInputProtocol	Protokol input untuk acara langsung. Ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui.
LiveEventInputTrackSelection	Kondisi pemilihan trek. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.
LiveEventOutputTranscriptionTrack	Menjelaskan trek transkripsi dalam output acara langsung, yang dihasilkan menggunakan transkripsi ucapan ke teks. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.
LiveEventPreview	Pengaturan pratinjau acara langsung.
LiveEventPreviewAccessControl	Kontrol akses IP untuk titik akhir pratinjau acara langsung.
LiveEventResourceState	Status sumber daya acara langsung. Lihat https://go.microsoft.com/fwlink/?linkid=2139012 untuk informasi lebih lanjut.
LiveEventTimedMetadataEndpoint	Titik akhir penyisipan metadata acara langsung.
LiveEventTranscription	Menjelaskan trek transkripsi dalam output acara langsung, yang dihasilkan menggunakan transkripsi ucapan ke teks. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.
StreamOptionsFlag	Opsi yang digunakan untuk LiveEvent. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui. Nilai yang valid untuk nilai entri array adalah 'Default' dan 'LowLatency'.
StretchMode	Menentukan bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah Tidak Ada
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

Nama	Jenis	Deskripsi
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Kebijakan akses klien.

Nama	Jenis	Deskripsi
clientAccessPolicy	string	Konten clientaccesspolicy.xml digunakan oleh Silverlight.
crossDomainPolicy	string	Konten crossdomain.xml digunakan oleh Silverlight.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

IPAccessControl

Kontrol akses IP.

Nama	Jenis	Deskripsi
allow	IPRange[]	Daftar izin IP.

IPRange

Rentang alamat IP dalam skema CIDR.

Nama	Jenis	Deskripsi
address	string	Alamat IP.
name	string	Nama yang mudah diingat untuk rentang alamat IP.
subnetPrefixLength	integer	Panjang awalan subnet mask (lihat notasi CIDR).

LiveEvent

Acara langsung.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya.
properties.created	string	Waktu pembuatan untuk acara langsung
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Kebijakan akses lintas situs acara langsung.
properties.description	string	Deskripsi untuk acara langsung.
properties.encoding	LiveEventEncoding	Pengaturan pengodean untuk acara langsung. Ini mengonfigurasi apakah encoder langsung digunakan untuk acara langsung dan pengaturan untuk encoder langsung jika digunakan.
properties.hostnamePrefix	string	Saat useStaticHostname diatur ke true, hostnamePrefix menentukan bagian pertama dari nama host yang ditetapkan ke pratinjau acara langsung dan menyerap titik akhir. Nama host akhir akan menjadi kombinasi dari awalan ini, nama akun layanan media dan kode pendek untuk pusat data Azure Media Services.
properties.input	LiveEventInput	Pengaturan input acara langsung. Ini menentukan bagaimana acara langsung menerima input dari encoder kontribusi.
properties.lastModified	string	Waktu terakhir dimodifikasi dari acara langsung.
properties.preview	LiveEventPreview	Pengaturan pratinjau acara langsung. Pratinjau memungkinkan produsen acara langsung untuk mempratinjau konten streaming langsung tanpa membuat output langsung apa pun.
properties.provisioningState	string	Status provisi acara langsung.
properties.resourceState	LiveEventResourceState	Status sumber daya acara langsung. Lihat https://go.microsoft.com/fwlink/?linkid=2139012 untuk informasi lebih lanjut.
properties.streamOptions	StreamOptionsFlag[]	Opsi yang digunakan untuk LiveEvent. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui. Nilai yang valid untuk nilai entri array adalah 'Default' dan 'LowLatency'.
properties.transcriptions	LiveEventTranscription[]	Pengaturan transkripsi langsung untuk acara langsung. Lihat https://go.microsoft.com/fwlink/?linkid=2133742 untuk informasi selengkapnya tentang fitur transkripsi langsung.
properties.useStaticHostname	boolean	Menentukan apakah nama host statis akan ditetapkan ke pratinjau acara langsung dan menyerap titik akhir. Nilai ini hanya dapat diperbarui jika acara langsung dalam status Siaga
systemData	systemData	Metadata sistem yang berkaitan dengan sumber daya ini.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Menentukan jenis acara langsung dan pengaturan pengodean opsional untuk pengodean acara langsung.

Nama	Jenis	Deskripsi
encodingType	LiveEventEncodingType	Jenis acara langsung. Saat encodingType diatur ke PassthroughBasic atau PassthroughStandard, layanan hanya melewati lapisan video dan audio yang masuk ke output. Saat encodingType diatur ke Standar atau Premium1080p, encoder langsung mentranskode aliran masuk ke beberapa laju bit atau lapisan. Lihat https://go.microsoft.com/fwlink/?linkid=2095101 untuk informasi lebih lanjut. Properti ini tidak dapat diubah setelah acara langsung dibuat.
keyFrameInterval	string	Gunakan nilai waktu ISO 8601 antara 0,5 hingga 20 detik untuk menentukan panjang fragmen output untuk trek video dan audio dari acara langsung pengodean. Misalnya, gunakan PT2S untuk menunjukkan 2 detik. Untuk trek video, ini juga menentukan interval bingkai kunci, atau panjang GoP (sekelompok gambar). Jika nilai ini tidak diatur untuk acara langsung pengodean, durasi fragmen default ke 2 detik. Nilai tidak dapat diatur untuk acara langsung pass-through.
presetName	string	Nama preset pengodean opsional, yang digunakan saat encodingType bukan None. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui. Jika encodingType diatur ke Standar, maka nama preset default adalah 'Default720p'. Jika tidak, jika encodingType diatur ke Premium1080p, preset defaultnya adalah 'Default1080p'.
stretchMode	StretchMode	Menentukan bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah Tidak Ada

LiveEventEncodingType

Jenis acara langsung. Saat encodingType diatur ke PassthroughBasic atau PassthroughStandard, layanan hanya melewati lapisan video dan audio yang masuk ke output. Saat encodingType diatur ke Standar atau Premium1080p, encoder langsung mentranskode aliran masuk ke beberapa laju bit atau lapisan. Lihat https://go.microsoft.com/fwlink/?linkid=2095101 untuk informasi lebih lanjut. Properti ini tidak dapat diubah setelah acara langsung dibuat.

Nama	Jenis	Deskripsi
None	string	Ini sama dengan PassthroughStandard, silakan lihat deskripsi di bawah ini. Nilai enumerasi ini tidak digunakan lagi.
PassthroughBasic	string	Aliran yang diserap melewati acara langsung dari encoder kontribusi tanpa pemrosesan lebih lanjut. Dalam mode PassthroughBasic, penyerapan dibatasi hingga 5Mbps dan hanya 1 output langsung bersamaan yang diizinkan. Transkripsi langsung tidak tersedia.
PassthroughStandard	string	Aliran yang diserap melewati acara langsung dari encoder kontribusi tanpa pemrosesan lebih lanjut. Transkripsi langsung tersedia. Batas laju bit penyerapan jauh lebih tinggi dan hingga 3 output langsung bersamaan diizinkan.
Premium1080p	string	Encoder langsung kontribusi mengirimkan aliran laju bit tunggal ke acara langsung dan Media Services membuat beberapa aliran laju bit. Output tidak boleh melebihi 1080p dalam resolusi.
Standard	string	Encoder langsung kontribusi mengirimkan aliran laju bit tunggal ke acara langsung dan Media Services membuat beberapa aliran laju bit. Output tidak boleh melebihi 720p dalam resolusi.

LiveEventEndpoint

Titik akhir acara langsung.

Nama	Jenis	Deskripsi
protocol	string	Protokol titik akhir.
url	string	URL titik akhir.

LiveEventInput

Input acara langsung.

Nama	Jenis	Deskripsi
accessControl	LiveEventInputAccessControl	Kontrol akses untuk input acara langsung.
accessToken	string	UUID dalam bentuk string untuk mengidentifikasi aliran secara unik. Ini dapat ditentukan pada waktu pembuatan tetapi tidak dapat diperbarui. Jika dihilangkan, layanan akan menghasilkan nilai unik.
endpoints	LiveEventEndpoint[]	Titik akhir input untuk acara langsung.
keyFrameIntervalDuration	string	Durasi waktu ISO 8601 dari durasi interval bingkai kunci input. Nilai ini menetapkan properti EXT-X-TARGETDURATION dalam output HLS. Misalnya, gunakan PT2S untuk menunjukkan 2 detik. Biarkan nilai kosong untuk pengodean acara langsung.
streamingProtocol	LiveEventInputProtocol	Protokol input untuk acara langsung. Ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Titik akhir metadata untuk acara langsung.

LiveEventInputAccessControl

Kontrol akses IP untuk input acara langsung.

Nama	Jenis	Deskripsi
ip	IPAccessControl	Properti kontrol akses IP.

LiveEventInputProtocol

Protokol input untuk acara langsung. Ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui.

Nama	Jenis	Deskripsi
FragmentedMP4	string	Input Smooth Streaming akan dikirim oleh encoder kontribusi ke acara langsung.
RTMP	string	Input RTMP akan dikirim oleh encoder kontribusi ke acara langsung.

LiveEventInputTrackSelection

Kondisi pemilihan trek. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.

Nama	Jenis	Deskripsi
operation	string	Membandingkan operasi. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.
property	string	Nama properti untuk dipilih. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.
value	string	Nilai properti untuk dipilih. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.

LiveEventOutputTranscriptionTrack

Menjelaskan trek transkripsi dalam output acara langsung, yang dihasilkan menggunakan transkripsi ucapan ke teks. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.

Nama	Jenis	Deskripsi
trackName	string	Nama trek output. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.

LiveEventPreview

Pengaturan pratinjau acara langsung.

Nama	Jenis	Deskripsi
accessControl	LiveEventPreviewAccessControl	Kontrol akses untuk pratinjau acara langsung.
alternativeMediaId	string	Pengidentifikasi media alternatif yang terkait dengan pencari streaming yang dibuat untuk pratinjau. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui. Pengidentifikasi dapat digunakan dalam CustomLicenseAcquisitionUrlTemplate atau CustomKeyAcquisitionUrlTemplate dari StreamingPolicy yang ditentukan di bidang StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Titik akhir untuk pratinjau. Jangan bagikan URL pratinjau dengan audiens acara langsung.
previewLocator	string	Pengidentifikasi pencari pratinjau dalam format Guid. Menentukan ini pada waktu pembuatan memungkinkan penelepon untuk mengetahui url pencari pratinjau sebelum peristiwa dibuat. Jika dihilangkan, layanan akan menghasilkan pengidentifikasi acak. Nilai ini tidak dapat diperbarui setelah acara langsung dibuat.
streamingPolicyName	string	Nama kebijakan streaming yang digunakan untuk pratinjau acara langsung. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui.

LiveEventPreviewAccessControl

Kontrol akses IP untuk titik akhir pratinjau acara langsung.

Nama	Jenis	Deskripsi
ip	IPAccessControl	Properti kontrol akses IP.

LiveEventResourceState

Status sumber daya acara langsung. Lihat https://go.microsoft.com/fwlink/?linkid=2139012 untuk informasi lebih lanjut.

Nama	Jenis	Deskripsi
Allocating	string	Tindakan alokasi dipanggil pada acara langsung dan sumber daya sedang disediakan untuk acara langsung ini. Setelah alokasi berhasil diselesaikan, acara langsung akan beralih ke status Siaga.
Deleting	string	Acara langsung sedang dihapus. Tidak ada penagihan yang terjadi dalam status sementara ini. Updates atau streaming tidak diizinkan selama status ini.
Running	string	Sumber daya acara langsung telah dialokasikan, penyerapan dan pratinjau URL telah dibuat, dan dapat menerima streaming langsung. Pada titik ini, penagihan aktif. Anda harus secara eksplisit Menghentikan sumber daya acara langsung untuk menghentikan penagihan lebih lanjut.
StandBy	string	Sumber daya acara langsung telah disediakan dan siap untuk memulai. Penagihan terjadi di negara bagian ini. Sebagian besar properti masih dapat diperbarui, namun penyerapan atau streaming tidak diizinkan selama status ini.
Starting	string	Acara langsung sedang dimulai dan sumber daya dialokasikan. Tidak ada penagihan yang terjadi pada status ini. Updates atau streaming tidak diizinkan selama status ini. Jika terjadi kesalahan, acara langsung akan kembali ke status Dihentikan.
Stopped	string	Ini adalah status awal pada acara langsung setelah pembuatan (kecuali autostart disetel ke true.) Tidak ada penagihan yang terjadi pada status ini. Dalam status ini, properti acara langsung dapat diperbarui tetapi streaming tidak diizinkan.
Stopping	string	Acara langsung sedang dihentikan dan provisi sumber daya sedang dibatalkan. Tidak ada penagihan yang terjadi dalam status sementara ini. Updates atau streaming tidak diizinkan selama status ini.

LiveEventTimedMetadataEndpoint

Titik akhir penyisipan metadata acara langsung.

Nama	Jenis	Deskripsi
url	string	URL titik akhir metadata.

LiveEventTranscription

Menjelaskan trek transkripsi dalam output acara langsung, yang dihasilkan menggunakan transkripsi ucapan ke teks. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.

Nama	Jenis	Deskripsi
inputTrackSelection	LiveEventInputTrackSelection[]	Menyediakan mekanisme untuk memilih trek audio di umpan langsung input, tempat transkripsi ucapan ke teks diterapkan. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.
language	string	Menentukan bahasa (lokal) yang akan digunakan untuk transkripsi ucapan ke teks – bahasa lisan harus cocok dengan bahasa lisan di trek audio. Nilai harus dalam format BCP-47 (misalnya: 'en-US'). Lihat https://go.microsoft.com/fwlink/?linkid=2133742 untuk informasi selengkapnya tentang fitur transkripsi langsung dan daftar bahasa yang didukung.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Menjelaskan trek transkripsi dalam output acara langsung, yang dihasilkan menggunakan transkripsi ucapan ke teks. Properti ini dicadangkan untuk digunakan di masa mendatang, nilai apa pun yang ditetapkan pada properti ini akan diabaikan.

StreamOptionsFlag

Opsi yang digunakan untuk LiveEvent. Nilai ini ditentukan pada waktu pembuatan dan tidak dapat diperbarui. Nilai yang valid untuk nilai entri array adalah 'Default' dan 'LowLatency'.

Nama	Jenis	Deskripsi
Default	string	Streaming langsung tanpa pengoptimalan latensi khusus.
LowLatency	string	Acara langsung memberikan latensi ujung ke ujung yang lebih rendah dengan mengurangi buffer internalnya.
LowLatencyV2	string	Acara langsung dioptimalkan untuk latensi end to end. Opsi ini hanya tersedia untuk mengodekan acara langsung dengan input RTMP. Output dapat dialirkan menggunakan format HLS atau DASH. Arsip output atau panjang mundur DVR dibatasi hingga 6 jam. Gunakan opsi aliran "LowLatency" untuk semua skenario lainnya.

StretchMode

Menentukan bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah Tidak Ada

Nama	Jenis	Deskripsi
AutoFit	string	Pad output (dengan kotak surat atau kotak pilar) untuk menghormati resolusi output, sambil memastikan bahwa wilayah video aktif dalam output memiliki rasio aspek yang sama dengan input. Misalnya, jika input adalah 1920x1080 dan preset pengodean meminta 1280x1280, maka output akan berada di 1280x1280, yang berisi persegi dalam 1280x720 pada rasio aspek 16:9, dan wilayah kotak pilar lebar 280 piksel di kiri dan kanan.
AutoSize	string	Ambil alih resolusi output, dan ubah agar sesuai dengan rasio aspek tampilan input, tanpa padding. Misalnya, jika input adalah 1920x1080 dan preset pengodean meminta 1280x1280, maka nilai dalam preset diambil alih, dan output akan berada di 1280x720, yang mempertahankan rasio aspek input 16:9.
None	string	Secara ketat menghormati resolusi output yang ditentukan dalam preset pengodean tanpa mempertimbangkan rasio aspek piksel atau rasio aspek tampilan video input.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir memodifikasi sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir mengubah sumber daya.