Saltar para o conteúdo
Referência da API
/
Telefones na Nuvem
/
/Live Streaming

Live Streaming

Inicia, consulta e encerra a transmissão ao vivo do Cloud Phone.

Operations

Iniciar transmissão ao vivo

Request

Inicia a transmissão ao vivo de um MP4 já enviado em um Cloud Phone.

  • Pré-requisitos: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe, e o serviço dele precisa suportar transmissão ao vivo. O fileId precisa se referir a um arquivo enviado como mídia de transmissão cujo upload foi concluído; qualquer outra coisa é rejeitada como inválida ou expirada.
  • Conclusão: aceito, não concluído. A resposta apenas confirma que o serviço recebeu a solicitação. Consulte /cloudphone/live/status até que liveStatus seja 1.
  • Observação: a restrição de apenas MP4 é aplicada no envio do arquivo, não aqui.
  • Nova tentativa: não há deduplicação; uma chamada repetida reemite o comando de início.

Erros de negócio documentados: 33300, 33301, 33401, 33418. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Bodyapplication/jsonrequired
phoneIdstringrequired

Cloud phone ID

Example:"190000000000000001"
fileIdstringrequired

ID of an uploaded MP4 live-streaming file (uploadType=2)

Example:"820000000000000001"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/live/start \
  -H 'Content-Type: application/json' \
  -d '{
    "phoneId": "190000000000000001",
    "fileId": "820000000000000001"
  }'

Responses

Request processed; inspect code for the business result

Bodyapplication/json
codeintegerrequired

Business result code; 0 indicates success

Example:0
msgstring or nullrequired

Error message; null when successful

Example:null
requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"
databooleanrequired

Whether the live-streaming operation succeeded

Response
{
  "code": 0,
  "msg": null,
  "data": true,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}