camera.startCapture

Démarre la capture vidéo ou la capture d'image par intervalles en fonction de la valeur de captureMode dans Options. Cette commande a été ajoutée au niveau d'API 2.

Paramètres

  • Cette commande ne comporte aucun paramètre dans le corps de la requête. S'il s'agit d'un intervalle d'image la capture vidéo ou vidéo est déterminée par l'option captureMode. Pour la capture par intervalle, le fait qu'il s'agisse d'une capture ouverte ou non dépend si captureNumber est supérieur ou égal à 0. captureMode, captureInterval et captureNumber doit être défini avant la capture d'intervalle. Seul captureMode doit être défini sur "vidéo". avant la vidéo qui ne peut être arrêtée qu'à l'aide de la commande camera.stopCapture.

Résultats

  • Capture ouverte (lorsque captureMode == "video" ou captureNumber == 0) <ph type="x-smartling-placeholder">
      </ph>
    • Aucun résultat.
  • Capture à intervalles non ouverts: <ph type="x-smartling-placeholder">
      </ph>
    • fileUrls::liste d'URL absolues pointant vers une image pour la capture par intervalles. Notez que cette commande ne renvoie pas fileUrls immédiatement, car la capture prend captureNumber pour terminer. La progression de la commande peut être en interrogeant régulièrement la caméra. Par exemple, lancez un sondage 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 s'exécute pas correctement (par exemple, seules 3 images sur prises avant que la caméra ne soit déchargée) ou si la caméra est déconnectée à partir du téléphone client au milieu, mais la commande se termine correctement, le client doit pouvoir obtenir les images camera.listFiles lorsqu'une nouvelle connexion est établie entre le client et la caméra.

Erreurs

  • disableCommand:la commande est actuellement désactivée. par exemple, l'appareil photo au milieu d'une capture vidéo ou d'une capture par intervalles.
  • invalidParameterName:le nom du paramètre n'est pas reconnu. Exemple : Impossible de reconnaître sessionId.

E/S de commande
Saisie de la 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."
    }
}