Live Events - Update

Riferimento

Servizio:: Media Services

Versione API:: 2022-11-01

Aggiornamenti impostazioni in un evento live esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
liveEventName	path	True	string	Il nome dell'evento live, la lunghezza massima è 32. Criterio di espressione regolare: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.input	True	LiveEventInput	Impostazioni di input evento live. Definisce il modo in cui l'evento live riceve l'input da un codificatore di contributi.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Criteri di accesso tra siti per eventi live.
properties.description		string	Descrizione dell'evento live.
properties.encoding		LiveEventEncoding	Impostazioni di codifica per l'evento live. Configura se viene usato un codificatore live per l'evento live e le impostazioni per il codificatore live se usato.
properties.hostnamePrefix		string	Quando useStaticHostname è impostato su true, il nome hostPrefix specifica la prima parte del nome host assegnato all'anteprima degli eventi live e inserisce gli endpoint. Il nome host finale sarà una combinazione di questo prefisso, il nome dell'account del servizio multimediale e un breve codice per il data center di Servizi multimediali di Azure.
properties.preview		LiveEventPreview	Impostazioni di anteprima dell'evento live. L'anteprima consente ai produttori di eventi live di visualizzare in anteprima il contenuto di live streaming senza creare alcun output live.
properties.streamOptions		StreamOptionsFlag[]	Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'.
properties.transcriptions		LiveEventTranscription[]	Impostazioni di trascrizione live per l'evento live. Per altre informazioni sulla funzionalità di trascrizione in tempo reale, vedere https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname		boolean	Specifica se un nome host statico verrebbe assegnato all'anteprima degli eventi live e agli endpoint di inserimento. Questo valore può essere aggiornato solo se l'evento live è in stato standby
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	LiveEvent	OK. La richiesta ha avuto esito positivo.
202 Accepted	LiveEvent	Accettato. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Vedere https://go.microsoft.com/fwlink/?linkid=2087017 per informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure.
Other Status Codes	ErrorResponse	Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Update a LiveEvent

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


import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.LiveEvent;
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 Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-
     * update.json
     */
    /**
     * Sample code: Update a LiveEvent.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void updateALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        LiveEvent resource = manager.liveEvents()
            .getWithResponse("mediaresources", "slitestmedia10", "myLiveEvent1", com.azure.core.util.Context.NONE)
            .getValue();
        resource.update().withTags(mapOf("tag1", "value1", "tag2", "value2", "tag3", "value3"))
            .withDescription("test event updated")
            .withInput(new LiveEventInput().withStreamingProtocol(LiveEventInputProtocol.FRAGMENTED_MP4)
                .withAccessControl(new LiveEventInputAccessControl().withIp(new IpAccessControl()
                    .withAllow(Arrays.asList(new IpRange().withName("AllowOne").withAddress("192.1.1.0")))))
                .withKeyFrameIntervalDuration("fakeTokenPlaceholder"))
            .withPreview(new LiveEventPreview()
                .withAccessControl(new LiveEventPreviewAccessControl().withIp(new IpAccessControl()
                    .withAllow(Arrays.asList(new IpRange().withName("AllowOne").withAddress("192.1.1.0"))))))
            .apply();
    }

    // Use "Map.of" if available
    @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

Risposta di esempio

Codice di stato:: 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
    }
  }
}

Codice di stato:: 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
    }
  }
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
CrossSiteAccessPolicies	Criteri di accesso client.
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
IPAccessControl	Controllo di accesso IP.
IPRange	Intervallo di indirizzi IP nello schema CIDR.
LiveEvent	Evento live.
LiveEventEncoding	Specifica il tipo di evento live e le impostazioni di codifica facoltative per la codifica degli eventi live.
LiveEventEncodingType	Tipo di evento live. Quando codificaType è impostata su Pass throughBasic o Pass throughStandard, il servizio passa semplicemente attraverso i livelli video e audio in ingresso all'output. Quando encodingType è impostato su Standard o Premium1080p, un codificatore live transcodes il flusso in ingresso in più velocità bit o livelli. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2095101. Questa proprietà non può essere modificata dopo la creazione dell'evento live.
LiveEventEndpoint	Endpoint evento live.
LiveEventInput	Input dell'evento live.
LiveEventInputAccessControl	Controllo di accesso IP per l'input dell'evento live.
LiveEventInputProtocol	Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato.
LiveEventInputTrackSelection	Condizione di selezione di traccia. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
LiveEventOutputTranscriptionTrack	Descrive una traccia di trascrizione nell'output di un evento live, generato usando la trascrizione vocale a testo. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
LiveEventPreview	Impostazioni dell'anteprima degli eventi live.
LiveEventPreviewAccessControl	Controllo di accesso IP per l'endpoint di anteprima dell'evento live.
LiveEventResourceState	Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint	Endpoint di inserimento dei metadati dell'evento live.
LiveEventTranscription	Descrive le tracce di trascrizione nell'output di un evento live, generato usando la trascrizione della sintesi vocale. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
StreamOptionsFlag	Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'.
StretchMode	Specifica il modo in cui il video di input verrà ridimensionato per adattare le risoluzioni di output desiderate. Il valore predefinito è Nessuno
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Criteri di accesso client.

Nome	Tipo	Descrizione
clientAccessPolicy	string	Contenuto di clientaccesspolicy.xml utilizzato da Silverlight.
crossDomainPolicy	string	Contenuto di crossdomain.xml utilizzato da Silverlight.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

IPAccessControl

Controllo di accesso IP.

Nome	Tipo	Descrizione
allow	IPRange[]	Elenco di indirizzi IP consentiti.

IPRange

Intervallo di indirizzi IP nello schema CIDR.

Nome	Tipo	Descrizione
address	string	Indirizzo IP.
name	string	Nome descrittivo per l'intervallo di indirizzi IP.
subnetPrefixLength	integer	Lunghezza del prefisso della subnet mask (vedere notazione CIDR).

LiveEvent

Evento live.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.created	string	Ora di creazione per l'evento live
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Criteri di accesso tra siti per eventi live.
properties.description	string	Descrizione dell'evento live.
properties.encoding	LiveEventEncoding	Impostazioni di codifica per l'evento live. Configura se viene usato un codificatore live per l'evento live e le impostazioni per il codificatore live, se usato.
properties.hostnamePrefix	string	Quando useStaticHostname è impostato su true, il nome hostPrefix specifica la prima parte del nome host assegnato all'anteprima degli eventi live e inserisce gli endpoint. Il nome host finale sarà una combinazione di questo prefisso, il nome dell'account del servizio multimediale e un breve codice per il data center di Servizi multimediali di Azure.
properties.input	LiveEventInput	Impostazioni di input degli eventi live. Definisce il modo in cui l'evento live riceve l'input da un codificatore di contributi.
properties.lastModified	string	Ora dell'ultima modifica dell'evento live.
properties.preview	LiveEventPreview	Impostazioni dell'anteprima degli eventi live. L'anteprima consente ai produttori di eventi live di visualizzare in anteprima il contenuto di streaming live senza creare alcun output live.
properties.provisioningState	string	Stato di provisioning dell'evento live.
properties.resourceState	LiveEventResourceState	Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions	StreamOptionsFlag[]	Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'.
properties.transcriptions	LiveEventTranscription[]	Impostazioni di trascrizione live per l'evento live. Per altre informazioni sulla funzionalità di trascrizione in tempo reale, vedere https://go.microsoft.com/fwlink/?linkid=2133742 .
properties.useStaticHostname	boolean	Specifica se un nome host statico verrebbe assegnato all'anteprima degli eventi live e agli endpoint di inserimento. Questo valore può essere aggiornato solo se l'evento live è in stato standby
systemData	systemData	Metadati di sistema relativi a questa risorsa.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Specifica il tipo di evento live e le impostazioni di codifica facoltative per la codifica degli eventi live.

Nome	Tipo	Descrizione
encodingType	LiveEventEncodingType	Tipo di evento live. Quando encodingType è impostato su PassthroughBasic o PassthroughStandard, il servizio passa semplicemente attraverso i livelli audio e video in ingresso all'output. Quando encodingType è impostato su Standard o Premium1080p, un codificatore live esegue la transcodifica del flusso in ingresso in più velocità in bit o livelli. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2095101. Questa proprietà non può essere modificata dopo la creazione dell'evento live.
keyFrameInterval	string	Usare un valore di ora ISO 8601 compreso tra 0,5 e 20 secondi per specificare la lunghezza del frammento di output per le tracce video e audio di un evento live di codifica. Ad esempio, usare PT2S per indicare 2 secondi. Per la traccia video definisce anche l'intervallo di fotogrammi chiave o la lunghezza di un GoP (gruppo di immagini). Se questo valore non è impostato per un evento live di codifica, la durata del frammento viene impostata su 2 secondi. Non è possibile impostare il valore per gli eventi live pass-through.
presetName	string	Nome del set di impostazioni di codifica facoltativo, usato quando encodingType non è Nessuno. Questo valore viene specificato al momento della creazione e non può essere aggiornato. Se encodingType è impostato su Standard, il nome predefinito del set di impostazioni è 'Default720p'. In caso contrario, se encodingType è impostato su Premium1080p, il set di impostazioni predefinito è "Default1080p".
stretchMode	StretchMode	Specifica il modo in cui il video di input verrà ridimensionato in base alle risoluzioni di output desiderate. Il valore predefinito è Nessuno

LiveEventEncodingType

Tipo di evento live. Quando codificaType è impostata su Pass throughBasic o Pass throughStandard, il servizio passa semplicemente attraverso i livelli video e audio in ingresso all'output. Quando encodingType è impostato su Standard o Premium1080p, un codificatore live transcodes il flusso in ingresso in più velocità bit o livelli. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2095101. Questa proprietà non può essere modificata dopo la creazione dell'evento live.

Nome	Tipo	Descrizione
None	string	Questa è la stessa di Pass throughStandard, vedere la descrizione seguente. Questo valore di enumerazione è deprecato.
PassthroughBasic	string	Il flusso inserito passa attraverso l'evento live dal codificatore di contributi senza alcuna ulteriore elaborazione. Nella modalità Pass throughBasic l'inserimento è limitato a un massimo di 5 Mbps e solo 1 output live simultaneo è consentito. La trascrizione in tempo reale non è disponibile.
PassthroughStandard	string	Il flusso inserito passa attraverso l'evento live dal codificatore di contributi senza alcuna ulteriore elaborazione. La trascrizione in tempo reale è disponibile. I limiti di bitrate di inserimento sono molto più elevati e sono consentiti fino a 3 output live simultanei.
Premium1080p	string	Un codificatore live di contributo invia un singolo flusso bitrate all'evento live e Servizi multimediali crea più flussi di bitrate. L'output non può superare i 1080p in risoluzione.
Standard	string	Un codificatore live di contributo invia un singolo flusso bitrate all'evento live e Servizi multimediali crea più flussi di bitrate. L'output non può superare i 720p in risoluzione.

LiveEventEndpoint

Endpoint evento live.

Nome	Tipo	Descrizione
protocol	string	Protocollo endpoint.
url	string	URL dell'endpoint.

LiveEventInput

Input dell'evento live.

Nome	Tipo	Descrizione
accessControl	LiveEventInputAccessControl	Controllo di accesso per l'input dell'evento live.
accessToken	string	UUID in formato stringa per identificare in modo univoco il flusso. Questa impostazione può essere specificata in fase di creazione, ma non può essere aggiornata. Se omesso, il servizio genererà un valore univoco.
endpoints	LiveEventEndpoint[]	Endpoint di input per l'evento live.
keyFrameIntervalDuration	string	Durata iso 8601 dell'intervallo di fotogrammi chiave dell'input. Questo valore imposta la proprietà EXT-X-TARGETDURATION nell'output HLS. Ad esempio, usare PT2S per indicare 2 secondi. Lasciare vuoto il valore per la codifica degli eventi live.
streamingProtocol	LiveEventInputProtocol	Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Endpoint dei metadati per l'evento live.

LiveEventInputAccessControl

Controllo di accesso IP per l'input dell'evento live.

Nome	Tipo	Descrizione
ip	IPAccessControl	Proprietà del controllo di accesso IP.

LiveEventInputProtocol

Protocollo di input per l'evento live. Questo valore viene specificato in fase di creazione e non può essere aggiornato.

Nome	Tipo	Descrizione
FragmentedMP4	string	L'input Smooth Streaming verrà inviato dal codificatore di contributi all'evento live.
RTMP	string	L'input RTMP verrà inviato dal codificatore di contributi all'evento live.

LiveEventInputTrackSelection

Condizione di selezione di traccia. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.

Nome	Tipo	Descrizione
operation	string	Confronto dell'operazione. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
property	string	Nome della proprietà da selezionare. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
value	string	Valore della proprietà da selezionare. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.

LiveEventOutputTranscriptionTrack

Descrive una traccia di trascrizione nell'output di un evento live, generato usando la trascrizione vocale a testo. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.

Nome	Tipo	Descrizione
trackName	string	Nome della traccia di output. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.

LiveEventPreview

Impostazioni dell'anteprima degli eventi live.

Nome	Tipo	Descrizione
accessControl	LiveEventPreviewAccessControl	Controllo di accesso per l'anteprima degli eventi live.
alternativeMediaId	string	Identificatore multimediale alternativo associato al localizzatore di streaming creato per l'anteprima. Questo valore viene specificato al momento della creazione e non può essere aggiornato. L'identificatore può essere usato in CustomLicenseAcquisitionUrlTemplate o CustomKeyAcquisitionUrlTemplate del FlussoPolicy specificato nel campo StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Endpoint per l'anteprima. Non condividere l'URL di anteprima con il gruppo di destinatari dell'evento live.
previewLocator	string	Identificatore del localizzatore di anteprima in formato Guid. Se si specifica questa impostazione al momento della creazione, il chiamante può conoscere l'URL del localizzatore di anteprima prima della creazione dell'evento. Se omesso, il servizio genererà un identificatore casuale. Questo valore non può essere aggiornato dopo la creazione dell'evento live.
streamingPolicyName	string	Nome dei criteri di streaming usati per l'anteprima dell'evento live. Questo valore viene specificato al momento della creazione e non può essere aggiornato.

LiveEventPreviewAccessControl

Controllo di accesso IP per l'endpoint di anteprima dell'evento live.

Nome	Tipo	Descrizione
ip	IPAccessControl	Proprietà del controllo di accesso IP.

LiveEventResourceState

Stato della risorsa dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.

Nome	Tipo	Descrizione
Allocating	string	L'azione di allocazione è stata chiamata all'evento live e alle risorse di cui viene effettuato il provisioning per questo evento live. Al termine dell'allocazione, l'evento live passerà allo stato StandBy.
Deleting	string	L'evento live viene eliminato. In questo stato di transizione non viene eseguita alcuna attività di fatturazione. Durante questo stato non sono consentiti aggiornamenti o streaming.
Running	string	Le risorse degli eventi live sono state allocate, inseriti e URL di anteprima sono stati generati ed è in grado di ricevere flussi live. A questo punto, la fatturazione è attiva. È necessario chiamare in modo esplicito Stop nella risorsa evento live per arrestare ulteriormente la fatturazione.
StandBy	string	Le risorse degli eventi live sono state sottoposte a provisioning e sono pronte per iniziare. La fatturazione si verifica in questo stato. La maggior parte delle proprietà può comunque essere aggiornata, tuttavia l'inserimento o lo streaming non è consentito durante questo stato.
Starting	string	L'evento live viene avviato e le risorse vengono allocate. In questo stato non viene eseguita alcuna attività di fatturazione. Durante questo stato non sono consentiti aggiornamenti o streaming. Se si verifica un errore, l'evento live restituisce lo stato Arrestato.
Stopped	string	Questo è lo stato iniziale dell'evento live dopo la creazione (a meno che l'avvio automatico non sia stato impostato su true). Nessuna fatturazione si verifica in questo stato. In questo stato, le proprietà degli eventi live possono essere aggiornate ma lo streaming non è consentito.
Stopping	string	L'evento live viene arrestato e le risorse vengono de-provisioning. In questo stato di transizione non viene eseguita alcuna attività di fatturazione. Durante questo stato non sono consentiti aggiornamenti o streaming.

LiveEventTimedMetadataEndpoint

Endpoint di inserimento dei metadati dell'evento live.

Nome	Tipo	Descrizione
url	string	URL dell'endpoint dei metadati.

LiveEventTranscription

Descrive le tracce di trascrizione nell'output di un evento live, generato usando la trascrizione della sintesi vocale. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.

Nome	Tipo	Descrizione
inputTrackSelection	LiveEventInputTrackSelection[]	Fornisce un meccanismo per selezionare la traccia audio nel feed live di input, a cui viene applicata la trascrizione della sintesi vocale. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
language	string	Specifica la lingua (impostazioni locali) da usare per la trascrizione della sintesi vocale. Deve corrispondere alla lingua parlata nella traccia audio. Il valore deve essere in formato BCP-47 ,ad esempio "en-US". Per https://go.microsoft.com/fwlink/?linkid=2133742 altre informazioni sulla funzionalità di trascrizione in tempo reale e sull'elenco delle lingue supportate, vedere .
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Descrive una traccia di trascrizione nell'output di un evento live, generato usando la trascrizione da riconoscimento vocale a testo. Questa proprietà è riservata per un utilizzo futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.

StreamOptionsFlag

Opzioni da usare per LiveEvent. Questo valore viene specificato al momento della creazione e non può essere aggiornato. I valori validi per i valori delle voci della matrice sono 'Default' e 'LowLatency'.

Nome	Tipo	Descrizione
Default	string	Streaming live senza ottimizzazioni di latenza speciali.
LowLatency	string	L'evento live offre una latenza end-to-end inferiore riducendo i buffer interni.
LowLatencyV2	string	L'evento live è ottimizzato per la latenza end-to-end. Questa opzione è disponibile solo per la codifica di eventi live con input RTMP. Gli output possono essere trasmessi usando formati HLS o DASH. La lunghezza dell'archivio o del DVR degli output è limitata a 6 ore. Usare l'opzione di flusso "LowLatency" per tutti gli altri scenari.

StretchMode

Specifica il modo in cui il video di input verrà ridimensionato per adattare le risoluzioni di output desiderate. Il valore predefinito è Nessuno

Nome	Tipo	Descrizione
AutoFit	string	Eseguire il pad dell'output (con casella di posta o colonna) per rispettare la risoluzione dell'output, assicurandosi che l'area video attiva nell'output abbia lo stesso rapporto di aspetto dell'input. Ad esempio, se l'input è 1920x1080 e il set di impostazioni di codifica richiede 1280x1280, l'output sarà a 1280x1280, che contiene un rettangolo interno pari a 1280x720 a proporzioni pari a 16:9 e le aree della casella di colonna 280 pixel a sinistra e destra.
AutoSize	string	Eseguire l'override della risoluzione dell'output e modificarla in modo che corrisponda al rapporto di aspetto visualizzato dell'input, senza spaziatura interna. Ad esempio, se l'input è 1920x1080 e il set di impostazioni di codifica richiede 1280x1280, il valore nel set di impostazioni viene sottoposto a override e l'output sarà a 1280x720, che mantiene il rapporto di aspetto di input 16:9.
None	string	Rispetta strettamente la risoluzione dell'output specificata nel set di impostazioni di codifica senza considerare il rapporto di aspetto del pixel o il rapporto di aspetto visualizzato del video di input.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite