Live Events - Create

Riferimento

Servizio:: Media Services

Versione API:: 2022-11-01

Creare un evento live
Crea un nuovo evento live.

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

Con parametri facoltativi:

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

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.
autoStart	query		boolean	Il flag indica se la risorsa deve essere avviata automaticamente alla creazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui vive 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 in tempo reale.
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 dell'evento live e inserisce gli endpoint. Il nome host finale sarebbe una combinazione di questo prefisso, il nome dell'account del servizio multimediale e un codice breve 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 in fase di creazione e non può essere aggiornato. I valori validi per i valori della voce 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 per altre informazioni.
properties.useStaticHostname		boolean	Specifica se un nome host statico verrà assegnato all'anteprima dell'evento live e inserisce gli endpoint. Questo valore può essere aggiornato solo se l'evento live è in stato standby
tags		object	Tag di risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	LiveEvent	OK. La richiesta ha avuto esito positivo.
201 Created	LiveEvent	Creazione riuscita. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Per https://go.microsoft.com/fwlink/?linkid=2087017 informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure tramite l'intestazione di risposta Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Risposta di errore di streaming che descrive perché l'operazione non è riuscita.

Esempio

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();
    }

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

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

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 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 di anteprima dell'evento 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 vocale a testo. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
StreamOptionsFlag	Opzioni da usare per LiveEvent. Questo valore viene specificato in fase di creazione e non può essere aggiornato. I valori validi per i valori della voce 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 usato da Silverlight.
crossDomainPolicy	string	Contenuto di crossdomain.xml usato 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. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui vive la risorsa
name	string	nome della risorsa.
properties.created	string	Tempo di creazione per l'evento live
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Criteri di accesso tra siti in tempo reale.
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 dell'evento live e inserisce gli endpoint. Il nome host finale sarebbe una combinazione di questo prefisso, il nome dell'account del servizio multimediale e un codice breve per il data center di Servizi multimediali di Azure.
properties.input	LiveEventInput	Impostazioni di input evento live. Definisce il modo in cui l'evento live riceve l'input da un codificatore di contributi.
properties.lastModified	string	L'ultima volta modificata dell'evento live.
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.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 in fase di creazione e non può essere aggiornato. I valori validi per i valori della voce 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 per altre informazioni.
properties.useStaticHostname	boolean	Specifica se un nome host statico verrà assegnato all'anteprima dell'evento live e inserisce gli endpoint. 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 di 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 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.
keyFrameInterval	string	Usare un valore di tempo 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. Impossibile impostare il valore per gli eventi live pass-through.
presetName	string	Nome del set di impostazioni di codifica facoltativo, usato quando codificaType non è Nessuno. Questo valore viene specificato in fase di creazione e non può essere aggiornato. Se la codificaType è impostata su Standard, il nome predefinito del set di impostazioni è "Default720p". In caso contrario, se il codificaType è impostato su Premium1080p, il set di impostazioni predefinito è "Default1080p".
stretchMode	StretchMode	Specifica il modo in cui il video di input verrà ridimensionato per adattare le 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 evento live.

Nome	Tipo	Descrizione
accessControl	LiveEventInputAccessControl	Controllo di accesso per l'input dell'evento live.
accessToken	string	Un UUID in formato stringa per identificare in modo univoco il flusso. Questa opzione 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 dell'intervallo di tempo 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 di anteprima dell'evento live.

Nome	Tipo	Descrizione
accessControl	LiveEventPreviewAccessControl	Controllo di accesso per l'anteprima dell'evento live.
alternativeMediaId	string	Identificatore multimediale alternativo associato al localizzatore di streaming creato per l'anteprima. Questo valore viene specificato in fase di creazione e non può essere aggiornato. L'identificatore può essere usato nel campo CustomLicenseAcquisitionUrlTemplate o CustomKeyAcquisitionUrlTemplate del flussoPolicy specificato nel campo StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Endpoint per l'anteprima. Non condividere l'URL di anteprima con il pubblico dell'evento live.
previewLocator	string	Identificatore del localizzatore di anteprima in formato Guid. Specificando questa operazione in fase di creazione, il chiamante consente al chiamante di 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 in fase di 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 vocale a testo. Questa proprietà è riservata per l'uso 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 vocale a testo. Questa proprietà è riservata per l'uso futuro, qualsiasi valore impostato su questa proprietà verrà ignorato.
language	string	Specifica la lingua (impostazioni locali) da usare per la trascrizione vocale-a-testo, che deve corrispondere alla lingua parlata nella traccia audio. Il valore deve essere in formato BCP-47 ,ad esempio "en-US". Per altre informazioni sulla funzionalità di trascrizione live e sull'elenco delle lingue supportate, vedere https://go.microsoft.com/fwlink/?linkid=2133742 altre informazioni.
outputTranscriptionTrack	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.

StreamOptionsFlag

Opzioni da usare per LiveEvent. Questo valore viene specificato in fase di creazione e non può essere aggiornato. I valori validi per i valori della voce della matrice sono "Default" e "LowLatency".

Nome	Tipo	Descrizione
Default	string	Live streaming senza ottimizzazioni di latenza speciali.
LowLatency	string	L'evento live fornisce una latenza finale inferiore alla fine riducendo i buffer interni.
LowLatencyV2	string	L'evento live è ottimizzato per la latenza end-to-end. Questa opzione è disponibile solo per codificare eventi live con input RTMP. Gli output possono essere trasmessi usando formati HLS o DASH. L'archivio di output o la lunghezza di riavvolgimento del DVR sono limitate 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 risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima risorsa.

Condividi tramite