Guia da câmera de casa inteligente
action.devices.types.CAMERA
- As câmeras são complexas, e os recursos variam de maneira significativa entre os fornecedores. Com o tempo, as câmeras adquirirão diversas características e atributos que descrevem recursos específicos, muitos dos quais podem interagir com o stream de vídeo/áudio de maneiras especiais, como enviar um stream para outro dispositivo, identificar o que está no stream, reproduzir feeds novamente etc.
Esse tipo indica que o dispositivo recebe o ícone da câmera e alguns sinônimos e aliases relacionados.
Recursos do dispositivo
Consulte a documentação de característica correspondente para ver detalhes de implementação, como atributos e estados compatíveis com o serviço e como criar respostas EXECUTE e QUERY.
Características necessárias
Essas características e comandos são obrigatórios, se aplicável ao seu
dispositivo. Se o dispositivo não for compatível com essas características, insira o código de erro de functionNotSupported
em uma resposta QUERY ou EXECUTE. Consulte Erros e exceções para mais informações.
Requisitos de qualidade
- Latência: precisa ser menor ou igual a 2.000 ms.
- Confiabilidade: precisa ser maior ou igual a 97%.
Exemplo de dispositivo: câmera simples
Esta seção contém exemplos de payloads de intent que representam uma "Câmera" comum com base no tipo de dispositivo e nas características acima. Se você adicionar ou remover características na implementação, modifique as respostas para refletir essas alterações.
Exemplo de resposta SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CAMERA", "traits": [ "action.devices.traits.CameraStream" ], "name": { "name": "Simple camera" }, "willReportState": true, "attributes": { "cameraStreamSupportedProtocols": [ "hls", "progressive_mp4" ], "cameraStreamNeedAuthToken": true, "cameraStreamNeedDrmEncryption": false }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Exemplo de resposta de QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true } } } }
Exemplos de comandos EXECUTE
GetCameraStream
Para mais detalhes sobre os parâmetros de comando, consulte a referência de
action.devices.traits.CameraStream
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.GetCameraStream", "params": { "StreamToChromecast": true, "SupportedStreamProtocols": [ "progressive_mp4" ] } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamReceiverAppId": "1g2f89213hg", "cameraStreamAuthToken": "12657342190192783", "cameraStreamProtocol": "progressive_mp4" } } ] } }
Dispositivo ERRORS
Veja a lista completa de erros e exceções.resourceUnavailable
: qualquer falha relacionada à geração do URL do stream.