Configura a latência da transmissão ao vivo.
Descrição da operação
-
Esta operação configura a latência para um domínio de transmissão.
-
O cache do lado do servidor armazena um número inteiro de GOPs. Portanto, a latência não pode ser menor que o tamanho do GOP. A latência real é estimada com base no tamanho do GOP. Por exemplo, se você definir RtmpDelay como 4 segundos para um stream RTMP e o tamanho do GOP for 2 segundos, a latência real varia de 2 segundos (4 - 2) a 6 segundos (4 + 2). Se o tamanho do GOP for maior que o RtmpDelay configurado, por exemplo, GOP = 5 segundos e RtmpDelay = 4 segundos, a latência flutua entre 0 e 9 segundos.
-
As configurações de latência não têm efeito para streams apenas de áudio. A latência padrão é próxima de 0 segundos.
-
Para a configuração HLS, o tamanho do segmento é calculado como `Delay / 3` e arredondado para baixo até o número inteiro mais próximo. O tamanho mínimo do segmento é de 1 segundo. O número máximo de segmentos é 4 se o tamanho do segmento for de 3 segundos ou mais. Caso contrário, o máximo é de 6 segmentos.
-
O tamanho real do segmento HLS não pode ser menor que o tamanho do GOP.
-
A latência HLS é calculada como: Tamanho do Segmento Configurado × 3.
-
Se você não chamar esta operação, o sistema usa os valores padrão. A latência padrão é de 2 segundos para RTMP e 4 segundos para FLV. Para HLS, o tamanho padrão do segmento é de 5 segundos, o que resulta em uma latência de 15 segundos com um máximo de 6 segmentos.
Limite de consultas por segundo (QPS)
O limite de QPS para esta operação é de 1.000 chamadas por segundo por usuário. Se você exceder esse limite, as chamadas de API serão limitadas, o que pode afetar seus negócios. Planeje suas chamadas de acordo.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
live:SetLiveStreamDelayConfig |
update |
*Domain
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Não |
O ID da região. |
cn-shanghai |
| DomainName |
string |
Sim |
O domínio de transmissão. |
example.com |
| HlsDelay |
integer |
Não |
A latência de reprodução HLS. Unidade: segundos. Nota
Se este parâmetro for deixado em branco, a latência será definida com base no valor de HlsLevel. |
4 |
| HlsLevel |
string |
Não |
O nível de latência HLS. Este parâmetro é ignorado se HlsDelay estiver definido. Valores válidos:
Nota
Se tanto HlsDelay quanto HlsLevel forem deixados em branco, o valor padrão short será usado. |
short |
| FlvDelay |
integer |
Não |
A latência de reprodução FLV. Unidade: segundos. Nota
Se este parâmetro for deixado em branco, a latência será definida com base no valor de FlvLevel. |
8 |
| FlvLevel |
string |
Não |
O nível de latência FLV. Este parâmetro é ignorado se FlvDelay estiver definido. Valores válidos:
Nota
Se tanto FlvDelay quanto FlvLevel forem deixados em branco, o valor padrão short será usado. |
medium |
| RtmpDelay |
integer |
Não |
A latência de reprodução RTMP. Unidade: segundos. Nota
Se este parâmetro for deixado em branco, a latência será definida com base no valor de RtmpLevel. |
4 |
| RtmpLevel |
string |
Não |
O nível de latência RTMP. Este parâmetro é ignorado se RtmpDelay estiver definido. Valores válidos:
Nota
Se tanto RtmpDelay quanto RtmpLevel forem deixados em branco, o valor padrão short será usado. |
short |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
4C747C97-7ECD-4C61-8A92-67AD806331FF |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "4C747C97-7ECD-4C61-8A92-67AD806331FF"
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.