--- name: azion-entregue-uma-transmissao-ao-vivo-a-partir-do-live-ingest description: >- Crie um connector do Live Ingest na região do seu encoder e envie as requisições dos espectadores de uma aplicação a ele com uma regra. --- # Entregue uma transmissão ao vivo a partir do Live Ingest Você cria o connector que leva uma transmissão ao vivo para a Azion e a regra que entrega essa transmissão aos espectadores, pelo Azion Console, pela Azion API ou pela Azion CLI. Para uma transmissão HLS que a sua própria origem produz, consulte [Implemente cache HLS para streaming ao vivo](/pt-br/documentacao/guias/midia-e-streaming/streaming/implementar-cache-hls/). Seu encoder envia a transmissão por RTMP ao [Live Ingest](/pt-br/documentacao/plataforma/connectors/live-ingest/ingestao-e-entrega/), que a converte para HLS: uma playlist, `.m3u8`, e os segmentos que ela lista, `.ts`. Os espectadores nunca chegam ao Live Ingest diretamente. Eles solicitam a transmissão a uma aplicação, e uma regra dessa aplicação nomeia o connector. ```mermaid %%{init: {"layout": "dagre", "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 12, "rankSpacing": 12, "padding": 6, "wrappingWidth": 70, "minNodeWidth": 40, "useMaxWidth": true}}}%% flowchart TD Encoder["Encoder"] -->|"RTMP para a região do connector"| LI["Live Ingest converte a transmissão para HLS"] LI --> Connector["connector do tipo live_ingest"] Player["Player do espectador"] -->|"requisição HTTPS"| Rule["regra da aplicação: Set Connector"] Rule --> Cache["Enforce HLS cache: playlist 5 segundos, segmento 60 segundos"] Cache -->|"cópia ausente ou expirada"| Connector Cache -->|"cópia válida"| Player ``` 1. O encoder envia a transmissão por RTMP ao Live Ingest, na região do connector. 2. O Live Ingest converte a transmissão para HLS. 3. O player de um espectador solicita a transmissão à aplicação, e o behavior *Set Connector* de uma regra nomeia o connector. 4. A Azion adiciona o behavior *Enforce HLS cache* a essa regra, que mantém cada playlist em cache por 5 segundos e cada segmento por 60 segundos. 5. Uma cópia válida em cache responde a todos os espectadores, e só uma cópia expirada ou ausente é buscada pelo connector. --- ## Pré-requisitos - Uma aplicação servida por um workload, com um hostname que os espectadores solicitam. Para criar os dois, consulte [Primeiros passos com Applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/). - Um encoder que envia RTMP com autenticação por usuário e senha. A Azion fornece as credenciais e as URLs de ingestão de um endpoint primário e de um endpoint de backup. Para o requisito, consulte [Ingestão](/pt-br/documentacao/plataforma/connectors/live-ingest/ingestao-e-entrega/#ingestao). - Um [personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/), para os procedimentos pela API. - A [Azion CLI](/pt-br/documentacao/devtools/cli/) instalada e autorizada, para os procedimentos pela CLI. - Acesso ao Azion Console, para os procedimentos pelo Console. Consulte [Acesse o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). Este guia não cobre como você obtém as URLs de ingestão e as credenciais, nem o formato da URL da playlist que os espectadores solicitam. Os exemplos usam `my-live-connector` para o connector e `us-east-1` para a região. Substitua-os pelos seus valores. --- ## Crie o connector do Live Ingest O connector carrega uma configuração, a região onde o Live Ingest recebe a transmissão. Escolha a região mais próxima do encoder, não dos espectadores: ela encurta o caminho que a transmissão percorre antes de a Azion recebê-la. A região aceita `us-east-1`, `us-east-2`, `br-east-1`, `br-east-2` e `br-east-3`. **Console** Para criar o connector no Azion Console: 1. **Abra a página Connectors** Acesse [Azion Console](https://console.azion.com/) > **Connectors**. 2. **Inicie um connector** A página **Create Connector** é aberta. 3. **Nomeie o connector** Em **General**, insira `my-live-connector` como **Name**. 4. **Selecione o tipo Live Ingest** Em **Connector Type**, selecione *Live Ingest*. 5. **Selecione a região** Em **Region**, selecione `us-east-1`. O campo é obrigatório. 6. **Selecione Create** O connector `my-live-connector` existe na sua conta em `us-east-1`. **API** Para criar o connector, envie o nome, o tipo e a região dele ao endpoint de connectors: ```bash curl --request POST \ --url https://api.azion.com/v4/workspace/connectors \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data '{ "name": "my-live-connector", "type": "live_ingest", "attributes": { "region": "us-east-1" } }' ``` A API responde `202` com `"state": "pending"`, e a leitura do connector retorna `"attributes": {"region": "us-east-1"}`. Anote o `id` dele: a regra nomeia o connector por ele. Uma requisição sem `region` falha com `10059`, e uma região fora dos cinco valores falha com `10039`. **CLI** Para criar o connector com a Azion CLI, salve o corpo dele como `connector.json`: ```json { "name": "my-live-connector", "type": "live_ingest", "attributes": { "region": "us-east-1" } } ``` Crie o connector a partir do arquivo. O comando precisa de `--type` mesmo quando o arquivo nomeia o tipo: ```bash azion create connector --type live_ingest --file connector.json ``` A saída traz o ID do novo connector, que a regra nomeia: ```text Created Connector with ID ``` O connector existe na sua conta, e nenhuma requisição de espectador chega a ele até que uma regra da aplicação o nomeie. Uma mudança em um connector chega à infraestrutura distribuída da Azion em alguns minutos. --- ## Envie as requisições dos espectadores ao connector Uma regra da Request Phase com o behavior *Set Connector* envia ao connector as requisições que ela corresponde. Em uma aplicação que serve só a transmissão, a regra corresponde a todos os paths: `${uri}` começa com `/`. Quando várias regras correspondentes carregam *Set Connector*, só a última é executada, então mantenha esta regra depois de qualquer regra que envie todos os paths a outro connector. Uma regra nova fica depois das regras que a aplicação já tem. **Console** Para criar a regra no Azion Console: 1. **Abra a aplicação** Acesse [Azion Console](https://console.azion.com/) > **Applications** e selecione a aplicação que entrega a transmissão. 2. **Selecione a aba Rules Engine** 3. **Selecione + Rule** 4. **Nomeie a regra** Em **General**, insira `send-to-live-ingest` como **Name**. 5. **Selecione a fase de requisição** Em **Phase**, selecione *Request Phase*. 6. **Defina o critério** Em **Criteria**, selecione a variável `${uri}` e o operador `starts_with`, e insira `/` como argumento. 7. **Selecione o behavior Set Connector** Em **Behaviors**, selecione *Set Connector*. 8. **Selecione o connector do Live Ingest** Em **Connector**, selecione `my-live-connector`. A Azion adiciona o behavior *Enforce HLS cache* à regra. 9. **Selecione Save** A regra aparece na aba **Rules Engine**, sob o título **Request**. **API** Para criar a regra, envie-a às regras da Request Phase da aplicação. Substitua `` pelo `id` do connector: ```bash curl --request POST \ --url https://api.azion.com/v4/workspace/applications//request_rules \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data '{ "name": "send-to-live-ingest", "active": true, "criteria": [[{ "variable": "${uri}", "conditional": "if", "operator": "starts_with", "argument": "/" }]], "behaviors": [{ "type": "set_connector", "attributes": { "value": } }] }' ``` A API responde `202` com `state` igual a `pending` e a regra como a plataforma a armazenou. O *Enforce HLS cache* não tem um `type` da API para enviar, porque a Azion o adiciona à regra. **CLI** Para criar a regra com a Azion CLI, mantenha-a em um arquivo, porque na linha de comando o shell expandiria `${uri}`. Salve este corpo como `rule.json` e substitua `` pelo ID do connector: ```json { "name": "send-to-live-ingest", "active": true, "criteria": [[{ "variable": "${uri}", "conditional": "if", "operator": "starts_with", "argument": "/" }]], "behaviors": [{ "type": "set_connector", "attributes": { "value": } }] } ``` Crie a regra na fase de requisição da aplicação: ```bash azion create rules-engine --application-id --phase request --file rule.json ``` A saída traz o ID da nova regra: ```text Created Rules Engine with ID ``` Todas as requisições da aplicação agora chegam à transmissão pelo connector, sob a política de cache de HLS ao vivo. Uma regra nova pode levar alguns minutos para se propagar. --- ## Deixe o cache da transmissão com o Enforce HLS cache O *Enforce HLS cache* ignora as configurações de cache da aplicação e aplica a política de cache que a Azion define para HLS ao vivo. Uma configuração de cache que um behavior *Set Cache Policy* aplica a essas requisições, portanto, não tem efeito, então não adicione uma. Para confirmar que a regra carrega a política: 1. **Abra a aba Rules Engine da aplicação** Acesse [Azion Console](https://console.azion.com/) > **Applications**, selecione a aplicação e selecione a aba **Rules Engine**. 2. **Abra a regra send-to-live-ingest** 3. **Leia os behaviors** A regra carrega *Set Connector*, nomeando `my-live-connector`, e *Enforce HLS cache*. A aplicação mantém cada playlist em cache por 5 segundos e cada segmento por 60 segundos. Uma cópia em cache de um segmento responde a todos os espectadores que o solicitam nesse tempo, então um público grande não envia cada uma das suas requisições ao Live Ingest. > **nota** > > O Live Ingest é cobrado por Data Ingestion, o volume de dados de transmissão que a Azion ingere, e uma transmissão de teste é ingerida como uma real. Para o valor, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#live-ingest). --- ## Próximos passos - [Ingestão e entrega](/pt-br/documentacao/plataforma/connectors/live-ingest/ingestao-e-entrega.md): Como o Live Ingest recebe a transmissão em uma região e como a aplicação a entrega. - [Boas práticas de Connectors](/pt-br/documentacao/plataforma/connectors/boas-praticas.md#live-ingest): Endpoints redundantes, configurações do encoder, fallback do player, alertas e um teste de carga antes do evento. - [Consulte os usuários conectados do Live Ingest](/pt-br/documentacao/guias/plataforma/observabilidade/query-dados-connected-users-com-graphql.md): Conte as sessões únicas da transmissão por host, durante e depois do evento. - [Transmita eventos ao vivo para grandes audiências](/pt-br/documentacao/casos-de-uso/entregar-midia-e-streaming/transmitir-eventos-ao-vivo-para-grandes-audiencias.md): Um evento ao vivo entregue a partir do Live Ingest a um público grande, com os seus valores e verificações.