Live Events - Create

Odwołanie

Usługa:: Media Services

Wersja interfejsu API:: 2022-11-01

Tworzenie wydarzenia na żywo
Tworzy nowe wydarzenie na żywo.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
liveEventName	path	True	string	Nazwa wydarzenia na żywo, maksymalna długość to 32. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API, która ma być używana z żądaniem klienta.
autoStart	query		boolean	Flaga wskazuje, czy zasób powinien zostać automatycznie uruchomiony podczas tworzenia.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
properties.input	True	LiveEventInput	Ustawienia danych wejściowych zdarzeń na żywo. Definiuje sposób, w jaki wydarzenie na żywo odbiera dane wejściowe z kodera udziału.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Zasady dostępu między witrynami wydarzenia na żywo.
properties.description		string	Opis wydarzenia na żywo.
properties.encoding		LiveEventEncoding	Ustawienia kodowania dla wydarzenia na żywo. Określa, czy koder na żywo jest używany na potrzeby wydarzenia na żywo i ustawień kodera na żywo, jeśli jest używany.
properties.hostnamePrefix		string	Jeśli parametr useStaticHostname ma wartość true, nazwa hostaPrefix określa pierwszą część nazwy hosta przypisaną do podglądu wydarzenia na żywo i pozyskiwania punktów końcowych. Końcowa nazwa hosta będzie kombinacją tego prefiksu, nazwy konta usługi multimediów i krótkiego kodu centrum danych usługi Azure Media Services.
properties.preview		LiveEventPreview	Ustawienia podglądu zdarzeń na żywo. Wersja zapoznawcza umożliwia producentom wydarzeń na żywo wyświetlanie podglądu zawartości transmisji strumieniowej na żywo bez tworzenia żadnych danych wyjściowych na żywo.
properties.streamOptions		StreamOptionsFlag[]	Opcje do użycia dla liveEvent. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wpisów tablicy to "Default" i "LowLatency".
properties.transcriptions		LiveEventTranscription[]	Ustawienia transkrypcji na żywo dla wydarzenia na żywo. Zobacz https://go.microsoft.com/fwlink/?linkid=2133742 , aby uzyskać więcej informacji na temat funkcji transkrypcji na żywo.
properties.useStaticHostname		boolean	Określa, czy statyczna nazwa hosta ma być przypisana do podglądu wydarzenia na żywo i pozyskiwania punktów końcowych. Tę wartość można zaktualizować tylko wtedy, gdy wydarzenie na żywo jest w stanie wstrzymania
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	LiveEvent	OK. Żądanie zakończyło się pomyślnie.
201 Created	LiveEvent	Utworzone. Żądanie zostało zaakceptowane na potrzeby przetwarzania, a operacja zostanie ukończona asynchronicznie. Aby https://go.microsoft.com/fwlink/?linkid=2087017 uzyskać szczegółowe informacje na temat monitorowania asynchronicznych operacji platformy Azure przy użyciu nagłówka odpowiedzi Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Odpowiedź z błędem przesyłania strumieniowego opisująca, dlaczego operacja nie powiodła się.

Przykłady

Create a LiveEvent

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

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

Przykładowa odpowiedź

Kod stanu:: 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

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

Kod stanu:: 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
    }
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
CrossSiteAccessPolicies	Zasady dostępu klienta.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IPAccessControl	Kontrola dostępu do adresu IP.
IPRange	Zakres adresów IP w schemacie CIDR.
LiveEvent	Wydarzenie na żywo.
LiveEventEncoding	Określa typ wydarzenia na żywo i opcjonalne ustawienia kodowania dla kodowania wydarzeń na żywo.
LiveEventEncodingType	Typ wydarzenia na żywo. Gdy właściwość encodingType jest ustawiona na wartość PassthroughBasic lub PassthroughStandard, usługa po prostu przechodzi przez przychodzące warstwy wideo i audio do danych wyjściowych. Gdy właściwość encodingType jest ustawiona na Standardowa lub Premium1080p, koder na żywo transkoduje strumień przychodzący na wiele szybkości transmisji bitów lub warstw. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2095101. Tej właściwości nie można zmodyfikować po utworzeniu wydarzenia na żywo.
LiveEventEndpoint	Punkt końcowy wydarzenia na żywo.
LiveEventInput	Dane wejściowe wydarzenia na żywo.
LiveEventInputAccessControl	Kontrola dostępu do adresu IP dla danych wejściowych zdarzeń na żywo.
LiveEventInputProtocol	Protokół wejściowy dla wydarzenia na żywo. Jest to określone w czasie tworzenia i nie można go zaktualizować.
LiveEventInputTrackSelection	Warunek wyboru śledzenia. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.
LiveEventOutputTranscriptionTrack	Opisuje ścieżkę transkrypcji w danych wyjściowych wydarzenia na żywo wygenerowanego przy użyciu transkrypcji zamiany mowy na tekst. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.
LiveEventPreview	Ustawienia podglądu zdarzeń na żywo.
LiveEventPreviewAccessControl	Kontrola dostępu do adresu IP dla punktu końcowego podglądu zdarzeń na żywo.
LiveEventResourceState	Stan zasobu wydarzenia na żywo. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint	Punkt końcowy wstawiania metadanych zdarzeń na żywo.
LiveEventTranscription	Opisuje ścieżki transkrypcji w danych wyjściowych wydarzenia na żywo wygenerowane przy użyciu transkrypcji zamiany mowy na tekst. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.
StreamOptionsFlag	Opcje do użycia dla liveEvent. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wpisów tablicy to "Default" i "LowLatency".
StretchMode	Określa sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to Brak
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Zasady dostępu klienta.

Nazwa	Typ	Opis
clientAccessPolicy	string	Zawartość clientaccesspolicy.xml używana przez program Silverlight.
crossDomainPolicy	string	Zawartość crossdomain.xml używana przez program Silverlight.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

IPAccessControl

Kontrola dostępu do adresu IP.

Nazwa	Typ	Opis
allow	IPRange[]	Lista dozwolonych adresów IP.

IPRange

Zakres adresów IP w schemacie CIDR.

Nazwa	Typ	Opis
address	string	Adres IP.
name	string	Przyjazna nazwa zakresu adresów IP.
subnetPrefixLength	integer	Długość prefiksu maski podsieci (zobacz notacja CIDR).

LiveEvent

Wydarzenie na żywo.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.created	string	Czas tworzenia wydarzenia na żywo
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Zasady dostępu między witrynami wydarzenia na żywo.
properties.description	string	Opis wydarzenia na żywo.
properties.encoding	LiveEventEncoding	Ustawienia kodowania dla wydarzenia na żywo. Określa, czy koder na żywo jest używany na potrzeby wydarzenia na żywo i ustawień kodera na żywo, jeśli jest używany.
properties.hostnamePrefix	string	Jeśli parametr useStaticHostname ma wartość true, nazwa hostaPrefix określa pierwszą część nazwy hosta przypisaną do podglądu wydarzenia na żywo i pozyskiwania punktów końcowych. Końcowa nazwa hosta będzie kombinacją tego prefiksu, nazwy konta usługi multimediów i krótkiego kodu centrum danych usługi Azure Media Services.
properties.input	LiveEventInput	Ustawienia danych wejściowych zdarzeń na żywo. Definiuje sposób, w jaki wydarzenie na żywo odbiera dane wejściowe z kodera udziału.
properties.lastModified	string	Godzina ostatniej modyfikacji wydarzenia na żywo.
properties.preview	LiveEventPreview	Ustawienia podglądu zdarzeń na żywo. Wersja zapoznawcza umożliwia producentom wydarzeń na żywo wyświetlanie podglądu zawartości transmisji strumieniowej na żywo bez tworzenia żadnych danych wyjściowych na żywo.
properties.provisioningState	string	Stan aprowizacji wydarzenia na żywo.
properties.resourceState	LiveEventResourceState	Stan zasobu wydarzenia na żywo. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions	StreamOptionsFlag[]	Opcje do użycia dla liveEvent. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wpisów tablicy to "Default" i "LowLatency".
properties.transcriptions	LiveEventTranscription[]	Ustawienia transkrypcji na żywo dla wydarzenia na żywo. Zobacz https://go.microsoft.com/fwlink/?linkid=2133742 , aby uzyskać więcej informacji na temat funkcji transkrypcji na żywo.
properties.useStaticHostname	boolean	Określa, czy statyczna nazwa hosta ma być przypisana do podglądu wydarzenia na żywo i pozyskiwania punktów końcowych. Tę wartość można zaktualizować tylko wtedy, gdy wydarzenie na żywo jest w stanie wstrzymania
systemData	systemData	Metadane systemowe odnoszące się do tego zasobu.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Określa typ wydarzenia na żywo i opcjonalne ustawienia kodowania dla kodowania wydarzeń na żywo.

Nazwa	Typ	Opis
encodingType	LiveEventEncodingType	Typ wydarzenia na żywo. Gdy właściwość encodingType jest ustawiona na wartość PassthroughBasic lub PassthroughStandard, usługa po prostu przechodzi przez przychodzące warstwy wideo i audio do danych wyjściowych. Gdy właściwość encodingType jest ustawiona na Standardowa lub Premium1080p, koder na żywo transkoduje strumień przychodzący na wiele szybkości transmisji bitów lub warstw. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2095101. Tej właściwości nie można zmodyfikować po utworzeniu wydarzenia na żywo.
keyFrameInterval	string	Użyj wartości czasu ISO 8601 z zakresu od 0,5 do 20 sekund, aby określić długość fragmentu wyjściowego dla ścieżek wideo i audio kodowania wydarzenia na żywo. Na przykład użyj pt2S, aby wskazać 2 sekundy. Dla ścieżki wideo definiuje również interwał klatek kluczowych lub długość goP (grupa obrazów). Jeśli ta wartość nie jest ustawiona dla zdarzenia na żywo kodowania, czas trwania fragmentu jest domyślnie ustawiony na 2 sekundy. Nie można ustawić wartości dla wydarzeń na żywo przekazywanych.
presetName	string	Opcjonalna wstępnie ustawiona nazwa kodowania używana, gdy wartość encodingType nie ma wartości None. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować. Jeśli właściwość encodingType jest ustawiona na Wartość Standardowa, domyślna nazwa ustawienia wstępnego to "Default720p". W przeciwnym razie, jeśli właściwość encodingType jest ustawiona na Wartość Premium1080p, domyślnym ustawieniem wstępnym jest "Default1080p".
stretchMode	StretchMode	Określa sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to Brak

LiveEventEncodingType

Typ wydarzenia na żywo. Gdy właściwość encodingType jest ustawiona na wartość PassthroughBasic lub PassthroughStandard, usługa po prostu przechodzi przez przychodzące warstwy wideo i audio do danych wyjściowych. Gdy właściwość encodingType jest ustawiona na Standardowa lub Premium1080p, koder na żywo transkoduje strumień przychodzący na wiele szybkości transmisji bitów lub warstw. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2095101. Tej właściwości nie można zmodyfikować po utworzeniu wydarzenia na żywo.

Nazwa	Typ	Opis
None	string	Jest to takie samo jak PassthroughStandard. Zobacz opis poniżej. Ta wartość wyliczenia jest przestarzała.
PassthroughBasic	string	Pozyskany strumień przechodzi przez wydarzenie na żywo z kodera udziału bez dalszego przetwarzania. W trybie PassthroughBasic pozyskiwanie jest ograniczone do maksymalnie 5 Mb/s i dozwolone jest tylko 1 współbieżne dane wyjściowe na żywo. Transkrypcja na żywo jest niedostępna.
PassthroughStandard	string	Pozyskany strumień przechodzi przez wydarzenie na żywo z kodera udziału bez dalszego przetwarzania. Dostępna jest transkrypcja na żywo. Limity szybkości transmisji bitów pozyskiwania są znacznie wyższe i dozwolone są maksymalnie 3 współbieżne dane wyjściowe na żywo.
Premium1080p	string	Koder na żywo współtworzenia wysyła strumień o pojedynczej szybkości transmisji bitów do wydarzenia na żywo, a usługa Media Services tworzy wiele strumieni szybkości transmisji bitów. Dane wyjściowe nie mogą przekraczać 1080p w rozdzielczości.
Standard	string	Koder na żywo współtworzenia wysyła strumień o pojedynczej szybkości transmisji bitów do wydarzenia na żywo, a usługa Media Services tworzy wiele strumieni szybkości transmisji bitów. Dane wyjściowe nie mogą przekraczać 720p w rozdzielczości.

LiveEventEndpoint

Punkt końcowy wydarzenia na żywo.

Nazwa	Typ	Opis
protocol	string	Protokół punktu końcowego.
url	string	Adres URL punktu końcowego.

LiveEventInput

Dane wejściowe wydarzenia na żywo.

Nazwa	Typ	Opis
accessControl	LiveEventInputAccessControl	Kontrola dostępu do danych wejściowych zdarzeń na żywo.
accessToken	string	Identyfikator UUID w postaci ciągu umożliwiający unikatową identyfikację strumienia. Można to określić w czasie tworzenia, ale nie można go zaktualizować. W przypadku pominięcia usługa wygeneruje unikatową wartość.
endpoints	LiveEventEndpoint[]	Wejściowe punkty końcowe dla wydarzenia na żywo.
keyFrameIntervalDuration	string	Czas trwania interwału klatek kluczowych dla danych wejściowych iso 8601. Ta wartość ustawia właściwość EXT-X-TARGETDURATION w danych wyjściowych HLS. Na przykład użyj pt2S, aby wskazać 2 sekundy. Pozostaw wartość pustą do kodowania wydarzeń na żywo.
streamingProtocol	LiveEventInputProtocol	Protokół wejściowy dla wydarzenia na żywo. Jest to określone w czasie tworzenia i nie można go zaktualizować.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Punkty końcowe metadanych dla wydarzenia na żywo.

LiveEventInputAccessControl

Kontrola dostępu do adresu IP dla danych wejściowych zdarzeń na żywo.

Nazwa	Typ	Opis
ip	IPAccessControl	Właściwości kontroli dostępu do adresu IP.

LiveEventInputProtocol

Protokół wejściowy dla wydarzenia na żywo. Jest to określone w czasie tworzenia i nie można go zaktualizować.

Nazwa	Typ	Opis
FragmentedMP4	string	Dane wejściowe Smooth Streaming będą wysyłane przez koder udziału do wydarzenia na żywo.
RTMP	string	Dane wejściowe RTMP będą wysyłane przez koder udziału do wydarzenia na żywo.

LiveEventInputTrackSelection

Warunek wyboru śledzenia. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.

Nazwa	Typ	Opis
operation	string	Porównywanie operacji. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.
property	string	Nazwa właściwości do wybrania. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.
value	string	Wartość właściwości do wybrania. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.

LiveEventOutputTranscriptionTrack

Opisuje ścieżkę transkrypcji w danych wyjściowych wydarzenia na żywo wygenerowanego przy użyciu transkrypcji zamiany mowy na tekst. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.

Nazwa	Typ	Opis
trackName	string	Nazwa ścieżki wyjściowej. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.

LiveEventPreview

Ustawienia podglądu zdarzeń na żywo.

Nazwa	Typ	Opis
accessControl	LiveEventPreviewAccessControl	Kontrola dostępu do podglądu wydarzeń na żywo.
alternativeMediaId	string	Alternatywny identyfikator multimediów skojarzony z lokalizatorem przesyłania strumieniowego utworzonym na potrzeby wersji zapoznawczej. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować. Identyfikator może być używany w polem CustomLicenseAcquisitionUrlTemplate lub CustomKeyAcquisitionUrlTemplate obiektu StreamingPolicy określonego w polu StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Punkty końcowe dla wersji zapoznawczej. Nie udostępniaj adresu URL podglądu odbiorcom wydarzeń na żywo.
previewLocator	string	Identyfikator lokalizatora podglądu w formacie Guid. Określenie tej wartości w czasie tworzenia umożliwia wywołującym poznanie adresu URL lokalizatora podglądu przed utworzeniem zdarzenia. W przypadku pominięcia usługa wygeneruje losowy identyfikator. Tej wartości nie można zaktualizować po utworzeniu wydarzenia na żywo.
streamingPolicyName	string	Nazwa zasad przesyłania strumieniowego używanych na potrzeby podglądu wydarzenia na żywo. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować.

LiveEventPreviewAccessControl

Kontrola dostępu do adresu IP dla punktu końcowego podglądu zdarzeń na żywo.

Nazwa	Typ	Opis
ip	IPAccessControl	Właściwości kontroli dostępu do adresu IP.

LiveEventResourceState

Stan zasobu wydarzenia na żywo. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2139012.

Nazwa	Typ	Opis
Allocating	string	Akcja przydzielenia została wywołana w przypadku wydarzenia na żywo, a zasoby są aprowidowane dla tego wydarzenia na żywo. Po pomyślnym zakończeniu alokacji wydarzenie na żywo przejdzie do stanu wstrzymania.
Deleting	string	Wydarzenie na żywo jest usuwane. W tym stanie przejściowym nie ma żadnych rozliczeń. Aktualizacje lub przesyłanie strumieniowe nie jest dozwolone w tym stanie.
Running	string	Przydzielono zasoby zdarzeń na żywo, wygenerowano adresy URL pozyskiwania i podglądu oraz można odbierać strumienie na żywo. W tym momencie rozliczenia są aktywne. Aby zatrzymać dalsze rozliczenia, należy jawnie wywołać metodę Zatrzymaj zasób wydarzenia na żywo.
StandBy	string	Zasoby zdarzeń na żywo zostały aprowidowane i są gotowe do uruchomienia. Rozliczenia są naliczane w tym stanie. Większość właściwości można nadal aktualizować, ale pozyskiwanie lub przesyłanie strumieniowe nie jest dozwolone w tym stanie.
Starting	string	Trwa uruchamianie wydarzenia na żywo i przydzielane są zasoby. W tym stanie nie ma żadnych rozliczeń. Aktualizacje lub przesyłanie strumieniowe nie jest dozwolone w tym stanie. Jeśli wystąpi błąd, zdarzenie na żywo powróci do stanu Zatrzymano.
Stopped	string	Jest to początkowy stan wydarzenia na żywo po utworzeniu (chyba że autostart został ustawiony na wartość true). W tym stanie nie ma żadnych rozliczeń. W tym stanie właściwości wydarzenia na żywo można zaktualizować, ale przesyłanie strumieniowe jest niedozwolone.
Stopping	string	Wydarzenie na żywo jest zatrzymywane, a zasoby są co do tego anulowane. W tym stanie przejściowym nie ma żadnych rozliczeń. Aktualizacje lub przesyłanie strumieniowe nie jest dozwolone w tym stanie.

LiveEventTimedMetadataEndpoint

Punkt końcowy wstawiania metadanych zdarzeń na żywo.

Nazwa	Typ	Opis
url	string	Adres URL punktu końcowego metadanych.

LiveEventTranscription

Opisuje ścieżki transkrypcji w danych wyjściowych wydarzenia na żywo wygenerowane przy użyciu transkrypcji zamiany mowy na tekst. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.

Nazwa	Typ	Opis
inputTrackSelection	LiveEventInputTrackSelection[]	Udostępnia mechanizm wybierania ścieżki audio w wejściowym kanale informacyjnym na żywo, do którego jest stosowana transkrypcja zamiany mowy na tekst. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.
language	string	Określa język (ustawienia regionalne), który ma być używany do transkrypcji zamiany mowy na tekst — powinien być zgodny z językiem mówionym w ścieżce audio. Wartość powinna być w formacie BCP-47 (np. "en-US"). Zobacz https://go.microsoft.com/fwlink/?linkid=2133742 , aby uzyskać więcej informacji na temat funkcji transkrypcji na żywo i listy obsługiwanych języków.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Opisuje ścieżkę transkrypcji w danych wyjściowych wydarzenia na żywo wygenerowanego przy użyciu transkrypcji zamiany mowy na tekst. Ta właściwość jest zarezerwowana do użytku w przyszłości. Każda wartość ustawiona na tej właściwości zostanie zignorowana.

StreamOptionsFlag

Opcje do użycia dla liveEvent. Ta wartość jest określana w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wpisów tablicy to "Default" i "LowLatency".

Nazwa	Typ	Opis
Default	string	Transmisja strumieniowa na żywo bez specjalnych optymalizacji opóźnień.
LowLatency	string	Wydarzenie na żywo zapewnia mniejsze opóźnienia końcowe dzięki zmniejszeniu buforów wewnętrznych.
LowLatencyV2	string	Wydarzenie na żywo jest zoptymalizowane pod kątem całkowitego opóźnienia. Ta opcja jest dostępna tylko do kodowania zdarzeń na żywo za pomocą danych wejściowych RTMP. Dane wyjściowe można przesyłać strumieniowo przy użyciu formatów HLS lub DASH. Długość przewijania archiwum danych wyjściowych lub dvr jest ograniczona do 6 godzin. Użyj opcji strumienia "LowLatency" dla wszystkich innych scenariuszy.

StretchMode

Określa sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to Brak

Nazwa	Typ	Opis
AutoFit	string	Dopełnij dane wyjściowe (z polem letterbox lub filarem), aby uhonorować rozdzielczość danych wyjściowych, zapewniając jednocześnie, że aktywny region wideo w danych wyjściowych ma taki sam współczynnik proporcji jak dane wejściowe. Jeśli na przykład dane wejściowe to 1920x1080, a ustawienie wstępne kodowania prosi o 1280 x 1280 x 1280, dane wyjściowe będą mieć wartość 1280x1280, która zawiera wewnętrzny prostokąt 1280 x 720 w proporcji 16:9, a obszary pola filaru mają szerokość 280 pikseli po lewej i prawej stronie.
AutoSize	string	Zastąpij rozdzielczość danych wyjściowych i zmień ją tak, aby była zgodna z współczynnikiem proporcji ekranu danych wejściowych bez dopełnienia. Jeśli na przykład dane wejściowe to 1920x1080, a ustawienie wstępne kodowania prosi o 1280 x 1280 x 1280, wartość w ustawieniu wstępnym zostanie zastąpiona, a dane wyjściowe będą mieć wartość 1280x720, która utrzymuje współczynnik proporcji wejściowych 16:9.
None	string	Ściśle uwzględnia rozdzielczość danych wyjściowych określoną w ustawieniu wstępnym kodowania bez uwzględniania współczynnika proporcji pikseli lub współczynnika proporcji ekranu wejściowego wideo.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem