Udostępnij za pośrednictwem

Live Events - Update

  • Odwołanie
Usługa:
Media Services
Wersja interfejsu API:
2022-11-01

Aktualizacje ustawienia istniejącego wydarzenia na żywo.

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

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 do użycia z żądaniem klienta.

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 do wydarzeń na żywo między witrynami.
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. Ostateczna nazwa hosta będzie kombinacją tego prefiksu, nazwy konta usługi medianej 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 w usłudze LiveEvent. Ta wartość jest określona w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wartości wpisu tablicy to "Default" i "LowLatency".
properties.transcriptions

LiveEventTranscription[]

Ustawienia transkrypcji na żywo dla wydarzenia na żywo. Aby uzyskać więcej informacji na temat funkcji transkrypcji na żywo, zobacz https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname

boolean

Określa, czy statyczna nazwa hosta zostanie 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.
202 Accepted

LiveEvent

Akceptowane. Żądanie zostało zaakceptowane do przetwarzania, a operacja zostanie ukończona asynchronicznie. Aby uzyskać szczegółowe informacje na temat asynchronicznych operacji platformy Azure, zobacz https://go.microsoft.com/fwlink/?linkid=2087017 szczegółowe informacje na temat monitorowania operacji platformy Azure.
Other Status Codes

ErrorResponse

Odpowiedź o błędzie przesyłania strumieniowego opisująca, dlaczego operacja nie powiodła się.

Przykłady

Update a LiveEvent

Przykładowe żądanie

PATCH 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",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "input": {
      "streamingProtocol": "FragmentedMP4",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0"
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0"
            }
          ]
        }
      }
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
202 
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",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "resourceState": "Running",
    "provisioningState": "InProgress",
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": 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",
    "tag3": "value3"
  },
  "properties": {
    "description": "test event updated",
    "resourceState": "Running",
    "provisioningState": "Succeeded",
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      }
    },
    "preview": {
      "previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowOne",
              "address": "192.1.1.0",
              "subnetPrefixLength": null
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": 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 zdarzeń 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 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 w usłudze LiveEvent. Ta wartość jest określona w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wartości wpisu 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 do wydarzeń na żywo między witrynami.
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 do 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. Ostateczna nazwa hosta będzie kombinacją tego prefiksu, nazwy konta usługi medianej i krótkiego kodu centrum danych usługi Azure Media Services.
properties.input

LiveEventInput

Ustawienia danych wejściowych wydarzenia na żywo. Definiuje sposób, w jaki wydarzenie na żywo odbiera dane wejściowe z kodera współtworzenia.
properties.lastModified

string

Ostatni zmodyfikowany czas 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 w usłudze LiveEvent. Ta wartość jest określona w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wartości wpisu tablicy to "Default" i "LowLatency".
properties.transcriptions

LiveEventTranscription[]

Ustawienia transkrypcji na żywo dla wydarzenia na żywo. Aby uzyskać więcej informacji na temat funkcji transkrypcji na żywo, zobacz https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname

boolean

Określa, czy statyczna nazwa hosta zostanie 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 dotyczące 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 zdarzeń na żywo.

Nazwa Typ Opis
encodingType

LiveEventEncodingType

Typ wydarzenia na żywo. Gdy typ kodowania jest ustawiony na PassthroughBasic lub PassthroughStandard, usługa po prostu przechodzi przez przychodzące warstwy wideo i audio do danych wyjściowych. Gdy typ kodowania ma ustawioną wartość Standard lub Premium1080p, koder na żywo transkoduje strumień przychodzący do wielu szybkości transmisji bitów lub warstw. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2095101. Nie można zmodyfikować tej właściwości 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. Śledzenie wideo definiuje również interwał ramki klucza 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 z przekazywaniem.
presetName

string

Opcjonalna nazwa ustawienia wstępnego kodowania używana podczas kodowaniaType nie ma wartości None. Ta wartość jest określona w czasie tworzenia i nie można jej zaktualizować. Jeśli typ kodowania jest ustawiony na Standard, domyślna nazwa wstępnie ustawiona to "Default720p". Jeśli typ kodowania ma wartość Premium1080p, domyślne ustawienie wstępne to "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 w celu unikatowego zidentyfikowania 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 przedziału czasu ramki klucza 8601 trwania danych wejściowych. 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 zdarzeń 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 dla wersji zapoznawczej. Ta wartość jest określona 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 tego elementu w czasie tworzenia umożliwia obiektowi wywołującego poznanie adresu URL lokalizatora wersji zapoznawczej 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 do podglądu wydarzenia na żywo. Ta wartość jest określona 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 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
inputTrackSelection

LiveEventInputTrackSelection[]

Udostępnia mechanizm wybierania ścieżki audio w wejściowym kanale informacyjnym na żywo, do którego zastosowano transkrypcję 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 w usłudze LiveEvent. Ta wartość jest określona w czasie tworzenia i nie można jej zaktualizować. Prawidłowe wartości wartości wpisu 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óźnienie dzięki zmniejszeniu buforów wewnętrznych.
LowLatencyV2

string

Wydarzenie na żywo jest zoptymalizowane pod kątem końca opóźnienia. Ta opcja jest dostępna tylko do kodowania zdarzeń na żywo z danymi wejściowymi RTMP. Dane wyjściowe można przesyłać strumieniowo przy użyciu formatów HLS lub DASH. Archiwum danych wyjściowych lub długość przewijania 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 zasobu (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.