camera.startCapture

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Lance la capture vidéo ou la capture par intervalles selon la valeur de captureMode dans Options. Cette commande a été ajoutée au niveau d'API 2.

Paramètres

  • Cette commande ne contient aucun paramètre dans le corps de la requête. La capture d'image par intervalles ou la capture vidéo est déterminée par l'option captureMode. Pour la capture par intervalles, qu'elle soit ouverte ou non, la valeur de captureNumber est égale ou supérieure à 0. captureMode, captureInterval et captureNumber doivent être définis avant la capture par intervalles. Seul captureMode doit être défini sur "video" avant la capture vidéo, qui ne peut être arrêtée que par la commande camera.stopCapture.

Résultats

  • Capture libre (lorsque captureMode == "video" ou captureNumber == 0)
    • Aucun résultat.
  • Capture d'intervalle non ouverte :
    • fileUrls : liste d'URL absolues pointant vers des fichiers image pour la capture par intervalles. Notez que cette commande ne renvoie pas fileUrls immédiatement, car la capture prend captureNumber. La progression de la commande peut être obtenue en interrogeant régulièrement la caméra. Par exemple, interrogation après une durée estimée (time = captureInterval * (captureNumber - 1)) à l'aide de l'API /osc/commands/status et fileUrls est le résultat renvoyé à la fin de la commande. Si la commande ne se termine pas correctement (par exemple, seulement trois des images ont été prises avant que la caméra soit à court de batterie) ou que la caméra soit déconnectée du téléphone client au milieu, mais que la commande aboutisse, le client devrait pouvoir récupérer les images camera.listFiles plus tard lorsqu'une nouvelle connexion sera établie entre le client et la caméra.

Erreurs

  • disabledCommand:la commande est actuellement désactivée. Par exemple, la caméra fait l'objet d'une capture vidéo ou d'une capture par intervalles.
  • invalidParameterName : le nom du paramètre n'est pas reconnu. Par exemple, sessionId n'est pas reconnu.

E/S de commande
Saisie de commande 
none
Résultat de la commande 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Résultat de la commande (erreur) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}