Live Events - Create

Referência

Serviço:: Media Services

Versão da API:: 2022-11-01

Criar Evento em Direto
Cria um novo evento em direto.

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

Com parâmetros opcionais:

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Multimédia.
liveEventName	path	True	string	O nome do evento em direto, comprimento máximo é 32. Padrão Regex: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	O nome do grupo de recursos na subscrição do Azure.
subscriptionId	path	True	string	O identificador exclusivo de uma subscrição do Microsoft Azure.
api-version	query	True	string	A versão da API a utilizar com o pedido de cliente.
autoStart	query		boolean	O sinalizador indica se o recurso deve ser iniciado automaticamente na criação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A localização geográfica onde o recurso se encontra
properties.input	True	LiveEventInput	Definições de entrada de eventos em direto. Define como o evento em direto recebe entradas de um codificador de contribuição.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Políticas de acesso entre sites de eventos em direto.
properties.description		string	Uma descrição para o evento em direto.
properties.encoding		LiveEventEncoding	Definições de codificação para o evento em direto. Configura se um codificador em direto é utilizado para o evento em direto e as definições do codificador em direto, se for utilizado.
properties.hostnamePrefix		string	Quando useStaticHostname está definido como verdadeiro, o hostnamePrefix especifica a primeira parte do nome do anfitrião atribuído à pré-visualização de eventos em direto e ingerir pontos finais. O nome de anfitrião final seria uma combinação deste prefixo, o nome da conta do serviço de multimédia e um código abreviado para o datacenter dos Serviços de Multimédia do Azure.
properties.preview		LiveEventPreview	Definições de pré-visualização de eventos em direto. A pré-visualização permite aos produtores de eventos em direto pré-visualizar o conteúdo de transmissão em fluxo em direto sem criar qualquer saída em direto.
properties.streamOptions		StreamOptionsFlag[]	As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada da matriz são "Predefinição" e "LowLatency".
properties.transcriptions		LiveEventTranscription[]	Definições de transcrição em direto para o evento em direto. Veja https://go.microsoft.com/fwlink/?linkid=2133742 para obter mais informações sobre a funcionalidade de transcrição em direto.
properties.useStaticHostname		boolean	Especifica se um nome de anfitrião estático seria atribuído à pré-visualização de eventos em direto e pontos finais de ingestão. Este valor só pode ser atualizado se o evento em direto estiver no estado De Espera
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	LiveEvent	OK. O pedido foi bem-sucedido.
201 Created	LiveEvent	Criado. O pedido foi aceite para processamento e a operação será concluída de forma assíncrona. Veja https://go.microsoft.com/fwlink/?linkid=2087017 os detalhes sobre a monitorização de operações assíncronas do Azure com o cabeçalho de resposta Azure-AsyncOperation.
Other Status Codes	ErrorResponse	A resposta a erros de transmissão em fluxo que descreve a razão pela qual a operação falhou.

Exemplos

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

Resposta da amostra

Código de estado:: 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
    }
  }
}

Código de estado:: 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
    }
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
CrossSiteAccessPolicies	A política de acesso do cliente.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
IPAccessControl	O controlo de acesso ao IP.
IPRange	O intervalo de endereços IP no esquema CIDR.
LiveEvent	O evento em direto.
LiveEventEncoding	Especifica o tipo de evento em direto e as definições de codificação opcionais para codificar eventos em direto.
LiveEventEncodingType	Tipo de evento em direto. Quando encodingType está definido como PassthroughBasic ou PassthroughStandard, o serviço simplesmente passa pelas camadas de áudio e vídeo recebidos para a saída. Quando encodingType está definido como Standard ou Premium1080p, um codificador dinâmico transcodifica o fluxo de entrada em múltiplas velocidades de transmissão ou camadas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obter mais informações. Esta propriedade não pode ser modificada após a criação do evento em direto.
LiveEventEndpoint	O ponto final do evento em direto.
LiveEventInput	A entrada do evento em direto.
LiveEventInputAccessControl	O controlo de acesso ip para entrada de eventos em direto.
LiveEventInputProtocol	O protocolo de entrada para o evento em direto. Esta ação é especificada no momento da criação e não pode ser atualizada.
LiveEventInputTrackSelection	Uma condição de seleção de registo. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
LiveEventOutputTranscriptionTrack	Descreve uma faixa de transcrição na saída de um evento em direto, gerado através da transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
LiveEventPreview	Definições de pré-visualização de eventos em direto.
LiveEventPreviewAccessControl	O controlo de acesso ip para o ponto final de pré-visualização de eventos em direto.
LiveEventResourceState	O estado do recurso do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.
LiveEventTimedMetadataEndpoint	O ponto final de inserção de metadados de eventos em direto.
LiveEventTranscription	Descreve as faixas de transcrição na saída de um evento em direto, geradas com a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
StreamOptionsFlag	As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada de matriz são "Predefinição" e "LowLatency".
StretchMode	Especifica como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é Nenhuma
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

A política de acesso do cliente.

Name	Tipo	Description
clientAccessPolicy	string	O conteúdo do clientaccesspolicy.xml utilizado pelo Silverlight.
crossDomainPolicy	string	O conteúdo do crossdomain.xml utilizado pelo Silverlight.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

IPAccessControl

O controlo de acesso ao IP.

Name	Tipo	Description
allow	IPRange[]	A lista de permissões de IP.

IPRange

O intervalo de endereços IP no esquema CIDR.

Name	Tipo	Description
address	string	O endereço IP.
name	string	O nome amigável do intervalo de endereços IP.
subnetPrefixLength	integer	O comprimento do prefixo da máscara de sub-rede (veja Notação CIDR).

LiveEvent

O evento em direto.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A localização geográfica onde reside o recurso
name	string	O nome do recurso
properties.created	string	A hora de criação do evento em direto
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Políticas de acesso a eventos em direto entre sites.
properties.description	string	Uma descrição para o evento em direto.
properties.encoding	LiveEventEncoding	Definições de codificação para o evento em direto. Configura se um codificador em direto é utilizado para o evento em direto e as definições do codificador em direto, se for utilizado.
properties.hostnamePrefix	string	Quando useStaticHostname está definido como verdadeiro, hostnamePrefix especifica a primeira parte do nome de anfitrião atribuído à pré-visualização do evento em direto e ingerir pontos finais. O nome de anfitrião final seria uma combinação deste prefixo, o nome da conta do serviço de multimédia e um código abreviado para o datacenter dos Serviços de Multimédia do Azure.
properties.input	LiveEventInput	Definições de entrada de eventos em direto. Define como o evento em direto recebe entradas de um codificador de contribuição.
properties.lastModified	string	A hora da última modificação do evento em direto.
properties.preview	LiveEventPreview	Definições de pré-visualização de eventos em direto. A pré-visualização permite que os produtores de eventos em direto pré-visualizem o conteúdo de transmissão em fluxo em direto sem criar qualquer saída em direto.
properties.provisioningState	string	O estado de aprovisionamento do evento em direto.
properties.resourceState	LiveEventResourceState	O estado do recurso do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.
properties.streamOptions	StreamOptionsFlag[]	As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada de matriz são "Predefinição" e "LowLatency".
properties.transcriptions	LiveEventTranscription[]	Definições de transcrição em direto para o evento em direto. Veja https://go.microsoft.com/fwlink/?linkid=2133742 para obter mais informações sobre a funcionalidade de transcrição em direto.
properties.useStaticHostname	boolean	Especifica se um nome de anfitrião estático seria atribuído à pré-visualização de eventos em direto e pontos finais de ingestão. Este valor só pode ser atualizado se o evento em direto estiver no estado Em Espera
systemData	systemData	Os metadados do sistema relacionados com este recurso.
tags	object	Etiquetas de recursos.
type	string	O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Especifica o tipo de evento em direto e as definições de codificação opcionais para codificar eventos em direto.

Name	Tipo	Description
encodingType	LiveEventEncodingType	Tipo de evento em direto. Quando encodingType está definido como PassthroughBasic ou PassthroughStandard, o serviço simplesmente passa pelas camadas de áudio e vídeo recebidos para a saída. Quando encodingType está definido como Standard ou Premium1080p, um codificador em direto transcodifica o fluxo de entrada em múltiplas velocidades de transmissão ou camadas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obter mais informações. Esta propriedade não pode ser modificada após a criação do evento em direto.
keyFrameInterval	string	Utilize um valor de tempo ISO 8601 entre 0,5 e 20 segundos para especificar o comprimento do fragmento de saída para as faixas de vídeo e áudio de um evento em direto de codificação. Por exemplo, utilize PT2S para indicar 2 segundos. Para a faixa de vídeo, também define o intervalo de fotogramas da chave ou o comprimento de um GoP (grupo de imagens). Se este valor não estiver definido para um evento em direto de codificação, a duração do fragmento é predefinida para 2 segundos. Não é possível definir o valor para eventos em direto pass-through.
presetName	string	O nome predefinido de codificação opcional, utilizado quando encodingType não é Nenhum. Este valor é especificado no momento da criação e não pode ser atualizado. Se o encodingType estiver definido como Standard, o nome predefinido predefinido é "Default720p". Caso contrário, se o encodingType estiver definido como Premium1080p, a predefinição predefinida é "Default1080p".
stretchMode	StretchMode	Especifica como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é Nenhuma

LiveEventEncodingType

Tipo de evento em direto. Quando encodingType está definido como PassthroughBasic ou PassthroughStandard, o serviço simplesmente passa pelas camadas de áudio e vídeo recebidos para a saída. Quando encodingType está definido como Standard ou Premium1080p, um codificador dinâmico transcodifica o fluxo de entrada em múltiplas velocidades de transmissão ou camadas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obter mais informações. Esta propriedade não pode ser modificada após a criação do evento em direto.

Name	Tipo	Description
None	string	Isto é o mesmo que PassthroughStandard. Veja a descrição abaixo. Este valor de enumeração está a ser preterido.
PassthroughBasic	string	O fluxo ingerido transmite o evento em direto a partir do codificador de contribuição sem qualquer processamento adicional. No modo PassthroughBasic, a ingestão está limitada a até 5 Mbps e só é permitida uma saída em direto simultânea. A transcrição em direto não está disponível.
PassthroughStandard	string	O fluxo ingerido transmite o evento em direto a partir do codificador de contribuição sem qualquer processamento adicional. A transcrição em direto está disponível. Os limites de taxa de ingestão de bits são muito mais elevados e são permitidas até 3 saídas em direto simultâneas.
Premium1080p	string	Um codificador em direto de contribuição envia uma única transmissão em fluxo de velocidade de transmissão para o evento em direto e os Serviços de Multimédia criam vários fluxos de velocidade de transmissão. O resultado não pode exceder os 1080p na resolução.
Standard	string	Um codificador em direto de contribuição envia uma única transmissão em fluxo de velocidade de transmissão para o evento em direto e os Serviços de Multimédia criam vários fluxos de velocidade de transmissão. O resultado não pode exceder os 720p na resolução.

LiveEventEndpoint

O ponto final do evento em direto.

Name	Tipo	Description
protocol	string	O protocolo de ponto final.
url	string	O URL do ponto final.

LiveEventInput

A entrada do evento em direto.

Name	Tipo	Description
accessControl	LiveEventInputAccessControl	Controlo de acesso para entrada de eventos em direto.
accessToken	string	Um UUID no formato de cadeia para identificar exclusivamente o fluxo. Isto pode ser especificado no momento da criação, mas não pode ser atualizado. Se for omitido, o serviço irá gerar um valor exclusivo.
endpoints	LiveEventEndpoint[]	Os pontos finais de entrada para o evento em direto.
keyFrameIntervalDuration	string	ISO 8601 duração de tempo da duração do intervalo do fotograma chave da entrada. Este valor define a propriedade EXT-X-TARGETDURATION na saída HLS. Por exemplo, utilize PT2S para indicar 2 segundos. Deixe o valor vazio para codificar eventos em direto.
streamingProtocol	LiveEventInputProtocol	O protocolo de entrada do evento em direto. Isto é especificado no momento da criação e não pode ser atualizado.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Os pontos finais de metadados do evento em direto.

LiveEventInputAccessControl

O controlo de acesso ip para entrada de eventos em direto.

Name	Tipo	Description
ip	IPAccessControl	As propriedades do controlo de acesso ao IP.

LiveEventInputProtocol

O protocolo de entrada para o evento em direto. Esta ação é especificada no momento da criação e não pode ser atualizada.

Name	Tipo	Description
FragmentedMP4	string	A entrada de Transmissão em Fluxo Suave será enviada pelo codificador de contribuição para o evento em direto.
RTMP	string	A entrada RTMP será enviada pelo codificador de contribuição para o evento em direto.

LiveEventInputTrackSelection

Uma condição de seleção de registo. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.

Name	Tipo	Description
operation	string	A comparar a operação. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
property	string	Nome da propriedade a selecionar. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
value	string	Valor da propriedade a selecionar. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.

LiveEventOutputTranscriptionTrack

Descreve uma faixa de transcrição na saída de um evento em direto, gerado através da transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.

Name	Tipo	Description
trackName	string	O nome da faixa de saída. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.

LiveEventPreview

Definições de pré-visualização de eventos em direto.

Name	Tipo	Description
accessControl	LiveEventPreviewAccessControl	O controlo de acesso para a pré-visualização de eventos em direto.
alternativeMediaId	string	Um identificador de multimédia alternativo associado ao localizador de transmissão em fluxo criado para a pré-visualização. Este valor é especificado no momento da criação e não pode ser atualizado. O identificador pode ser utilizado no campo CustomLicenseAcquisitionUrlTemplate ou CustomKeyAcquisitionUrlTemplate da StreamingPolicy especificado no campo StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Os pontos finais para pré-visualização. Não partilhe o URL de pré-visualização com a audiência do evento em direto.
previewLocator	string	O identificador do localizador de pré-visualização no formato Guid. Especificar isto no momento da criação permite que o autor da chamada saiba o URL do localizador de pré-visualização antes de o evento ser criado. Se for omitido, o serviço irá gerar um identificador aleatório. Este valor não pode ser atualizado depois de o evento em direto ser criado.
streamingPolicyName	string	O nome da política de transmissão em fluxo utilizada para a pré-visualização de eventos em direto. Este valor é especificado no momento da criação e não pode ser atualizado.

LiveEventPreviewAccessControl

O controlo de acesso ip para o ponto final de pré-visualização de eventos em direto.

Name	Tipo	Description
ip	IPAccessControl	As propriedades do controlo de acesso ao IP.

LiveEventResourceState

O estado do recurso do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.

Name	Tipo	Description
Allocating	string	A ação de alocação foi chamada no evento em direto e os recursos estão a ser aprovisionados para este evento em direto. Assim que a alocação for concluída com êxito, o evento em direto transitará para o estado StandBy.
Deleting	string	O evento em direto está a ser eliminado. Não ocorre nenhuma faturação neste estado transitório. Atualizações ou transmissão em fluxo não são permitidas durante este estado.
Running	string	Os recursos de eventos em direto foram alocados, foram gerados URLs de ingestão e pré-visualização e é capaz de receber transmissões em direto. Neste momento, a faturação está ativa. Tem de chamar explicitamente Parar no recurso de evento em direto para parar a faturação adicional.
StandBy	string	Os recursos de eventos em direto foram aprovisionados e estão prontos para começar. A faturação ocorre neste estado. A maioria das propriedades ainda pode ser atualizada, no entanto, a ingestão ou transmissão em fluxo não é permitida durante este estado.
Starting	string	O evento em direto está a ser iniciado e os recursos estão a ser alocados. Não ocorre nenhuma faturação neste estado. Atualizações ou transmissão em fluxo não são permitidas durante este estado. Se ocorrer um erro, o evento em direto regressa ao estado Parado.
Stopped	string	Este é o estado inicial do evento em direto após a criação (a menos que o início automático tenha sido definido como verdadeiro.) Não ocorre nenhuma faturação neste estado. Neste estado, as propriedades do evento em direto podem ser atualizadas, mas a transmissão em fluxo não é permitida.
Stopping	string	O evento em direto está a ser interrompido e os recursos estão a ser desaprovisionados. Não ocorre nenhuma faturação neste estado transitório. Atualizações ou transmissão em fluxo não são permitidas durante este estado.

LiveEventTimedMetadataEndpoint

O ponto final de inserção de metadados de eventos em direto.

Name	Tipo	Description
url	string	O URL do ponto final de metadados.

LiveEventTranscription

Descreve as faixas de transcrição na saída de um evento em direto, geradas com a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.

Name	Tipo	Description
inputTrackSelection	LiveEventInputTrackSelection[]	Fornece um mecanismo para selecionar a faixa de áudio no feed dinâmico de entrada, ao qual a transcrição de voz em texto é aplicada. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
language	string	Especifica o idioma (região) a utilizar para a transcrição de voz em texto– deve corresponder ao idioma falado na faixa de áudio. O valor deve estar no formato BCP-47 (por exemplo, "en-US"). Veja https://go.microsoft.com/fwlink/?linkid=2133742 para obter mais informações sobre a funcionalidade de transcrição em direto e a lista de idiomas suportados.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Descreve uma faixa de transcrição na saída de um evento em direto, gerada com a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.

StreamOptionsFlag

As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada de matriz são "Predefinição" e "LowLatency".

Name	Tipo	Description
Default	string	Transmissão em fluxo em direto sem otimizações de latência especiais.
LowLatency	string	O evento em direto proporciona latência de ponto a ponto inferior ao reduzir as memórias intermédias internas.
LowLatencyV2	string	O evento em direto está otimizado para latência ponto a ponto. Esta opção só está disponível para codificar eventos em direto com entrada RTMP. As saídas podem ser transmitidas em fluxo com formatos HLS ou DASH. O comprimento de rebobinamento do DVR ou arquivo das saídas está limitado a 6 horas. Utilize a opção de fluxo "LowLatency" para todos os outros cenários.

StretchMode

Especifica como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é Nenhuma

Name	Tipo	Description
AutoFit	string	Aloja a saída (com a caixa de correio ou a caixa de pilar) para respeitar a resolução de saída, garantindo ao mesmo tempo que a região de vídeo ativa na saída tem a mesma proporção que a entrada. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, o resultado será 1280x1280, que contém um retângulo interno de 1280x720 na proporção de 16:9 e regiões de caixa de pilares com 280 pixels de largura à esquerda e à direita.
AutoSize	string	Substitua a resolução de saída e altere-a para corresponder à proporção de apresentação da entrada, sem preenchimento. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, o valor no predefinido é substituído e o resultado será 1280x720, o que mantém a proporção de entrada de 16:9.
None	string	Respeita estritamente a resolução de saída especificada na predefinição de codificação sem considerar a proporção de píxeis ou a proporção de apresentação do vídeo de entrada.

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via