Options

Le tableau suivant présente toutes les options que vous pouvez définir et obtenir pour camera.setOptions et camera.getOptions. Impossible de modifier une option lorsque la compatibilité correspondante est vide ou ne contient qu'une seule option.

Nom Type Description Lecture/Écriture
captureMode Chaîne Mode de capture actuel. Valeur par défaut : image. rw
captureModeSupport Tableau de chaînes Liste des modes de capture actuellement disponibles. La configuration minimale requise pour le niveau d'API 1 est ["image"], et la condition minimale pour le niveau d'API 2 est ["image", "interval"], où "interval" représente le mode de capture d'une série d'images espacées à un certain intervalle. Veuillez également consulter captureInterval et captureIntervalSupport. Deux modes supplémentaires ("video" and "walkaround") sont compatibles avec le niveau d'API 2. Par conséquent, l'ensemble complet pris en charge par le niveau d'API 2 est ["image", "interval", "video", "walkaround"], où "video" représente le mode de capture vidéo et "walkaround" représente le mode de capture de deux images consécutives, la première avec les utilisateurs debout n'importe où par rapport à la caméra et l'autre avec les utilisateurs se tenant de l'autre côté (par rapport au premier point debout) de la caméra. Cela permet à l'appareil photo de supprimer les utilisateurs de l'image finale en combinant les deux images. Lorsque "walkaround" est pris en charge par l'appareil photo et défini comme mode de capture actuel, le client doit s'attendre à envoyer deux commandes takePicture à l'appareil photo. La réponse de la première commande (une fois celle-ci terminée) indique que l'appareil photo est prêt à prendre la deuxième image, tandis que la seconde commande doit renvoyer l'image finale une fois l'opération terminée.

Pour ajouter d'autres modes de capture qui ne sont pas encore pris en charge, ajoutez un trait de soulignement en préfixe aux modes spécifiques au fournisseur ( _).

Cette option a été modifiée au niveau d'API 2.

 r
captureStatus Chaîne État actuel de la capture. Valeur par défaut : "idle" Cela permet de déterminer l'état de la caméra lorsqu'elle est connectée à une application pour la première fois. Si la caméra est en train de filmer une vidéo, vous devrez peut-être l'arrêter avant d'être invité à effectuer d'autres tâches, par exemple le tournage d'une autre vidéo.

Cette option a été ajoutée au niveau d'API 2.1.

 rw
captureStatusSupport Tableau de chaînes Liste des états de capture actuellement disponibles La valeur par défaut doit être ["idle", "shooting"] si l'enregistrement vidéo est pris en charge. Vous pouvez également fournir d'autres statues, par exemple "downloading"

Cette option a été ajoutée au niveau d'API 2.1.

 r
exposureProgram Nombre Programme d'exposition actuel. rw
exposureProgramSupport Tableau de nombres Liste des programmes d'exposition actuellement disponibles Exemple : [0, 1, 2, 3, 4]. Chaque nombre entier représente un programme d'exposition différent: <ph type="x-smartling-placeholder">
    </ph>
  • 0 = Non défini
  • 1 = Manuel
  • 2 = Programme normal
  • 3 = Priorité ouverture
  • 4 = Priorité de l'obturateur
Cliquez sur le lien suivant pour télécharger plus d'informations sur ExposureProgram. 		r
iso Nombre Paramètre de vitesse ISO actuel. rw
isoSupport Tableau de nombres

Niveau d'API 1:liste des paramètres ISO actuellement disponibles (par exemple, [100, 200, 400, 800,1600] ou [] lorsqu'il est en mode auto).

Niveau d'API 2:liste des paramètres ISO actuellement disponibles (par exemple, [0, 100, 200, 400, 800, 1600], où 0 représente le mode auto).

Cette option a été modifiée au niveau d'API 2.

 r
shutterSpeed Nombre Vitesse d'obturation actuelle rw
shutterSpeedSupport Tableau de nombres

Niveau d'API 1:liste des vitesses d'obturation actuellement disponibles (par exemple, [0.067, 0.033, 0.017,0.008] ou [] lorsqu'il est en mode auto).

Niveau d'API 2:liste des vitesses d'obturation actuellement disponibles (par exemple, [0, 0.067, 0.033, 0.017, 0.008], où 0 représente le mode auto).

Cette option a été modifiée au niveau d'API 2.

 r
aperture Nombre Réglage d'ouverture actuel, en ouvertures de diaphragme. rw
apertureSupport Tableau de nombres

Niveau d'API 1:liste des paramètres d'ouverture actuellement disponibles, exprimés au format f/number. pour par exemple, [1.4, 2, 2.8, 4, 5.6, 8, 11] ou [] lorsqu'il est en mode auto.

Niveau d'API 2:liste des paramètres d'ouverture actuellement disponibles, exprimés au format f/number. par exemple, [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], où 0 représente le mode auto.

 r
whiteBalance Chaîne Réglage actuel de la balance des blancs Exemple : daylight. La valeur par défaut est auto. rw
whiteBalanceSupport Tableau de chaînes La liste des paramètres de balance des blancs actuellement disponibles peut être un sous-ensemble de la liste prédéfinie:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Valeurs pour chacun: <ph type="x-smartling-placeholder">
    </ph>
  • incandescent, environ 3 200 000
  • fluorescent, environ 4 000 000
  • datalight, environ 5 200 000
  • cloudy-daylight, environ 6 000 000
  • shade, environ 7 000 000
  • twilight, environ 12 000 000
Ajoutez un trait de soulignement aux noms de paramètres spécifiques aux fournisseurs. Exemple: _vendor-setting		 r
exposureCompensation Nombre Correction d'exposition actuelle. rw
exposureCompensationSupport Tableau de nombres Liste des corrections d'exposition actuellement disponibles, généralement à l'étape 0.33 ou 0,5 ; Exemple: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Objet

Type de fichier actuel et résolution Le format doit refléter la valeur actuelle de captureMode. Par exemple, si captureMode est image, une réponse appropriée peut être:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Si captureMode est video, une réponse appropriée peut être: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Cette option a été modifiée au niveau d'API 2.

 rw
fileFormatSupport Tableau d'objets

Liste des formats de fichiers actuellement disponibles Par exemple:

[
    {
    "type": "jpeg",
    "width": 2000,
    "height": 1000
    },
    {
    "type": "jpeg",
    "width": 200,
    "height": 100
    },
    {
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 24
    },
    {
    "type": "mp4",
    "width": 1280,
    "height": 720,
    "framerate": 30
    },
    ...
]
Cliquez sur le lien suivant pour en savoir plus sur tous les types.

Cette option a été modifiée au niveau d'API 2.

 r
exposureDelay Nombre Délai actuel (en secondes) entre la commande takePicture et le début de l'exposition. rw
exposureDelaySupport Tableau de nombres Liste des délais d'exposition actuellement disponibles (en secondes) Exemple: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Nombre Délai actuel avant la mise en veille de la caméra, en secondes. rw
sleepDelaySupport Tableau de nombres Liste des retards de sommeil actuellement disponibles, en secondes Exemple : [30, 60, 120, 300, 600, 1800, 65535], où 65535 désactive le mode Sommeil (la caméra ne passe en veille qu'une fois éteinte) et doit être prise en charge. r
offDelay Nombre Délai avant extinction de la caméra, en secondes. rw
offDelaySupport Tableau de nombres Liste des délais d'arrêt actuellement disponibles (en secondes) Exemple : [1800, 3600, 7200, 65535], où 65535 désactive le mode Éteindre (la caméra ne s'éteint qu'une fois la batterie déchargée ou éteinte manuellement) et doit être compatible. r
totalSpace Nombre Lecture seule: nombre d'octets de l'espace de stockage total. r
remainingSpace Nombre Lecture seule: nombre d'octets de stockage disponible. r
remainingPictures Nombre Lecture seule: estimation du nombre de photos restantes d'après la capture actuelle . r
gpsInfo Objet

Informations GPS actuelles. Définissez avec setOptions à l'aide du GPS du téléphone:

{
    "lat": 23.532,
    "lng": -132.35
}
Les propriétés lat et lng sont des degrés décimaux, lat dans la plage, [-90, 90] et lng dans la plage [-180, 180]. Lorsque les coordonnées GPS sont fournies par un téléphone, elles ne sont valides jusqu'à la prochaine mise à jour sur votre téléphone. Le téléphone doit déterminer quand effectuer la mise à jour la position GPS ; par exemple juste avant chaque commande takePicture. 65535 informe l'appareil photo que la position GPS actuelle n'est pas valide et qu'il reçoit des informations doit l'ignorer et utiliser son propre GPS s'il existe ; Exemple : setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) signifie que la position GPS est non valide.		 rw
dateTimeZone Chaîne Informations sur la date et l'heure actuelles. Défini par setOptions à l'aide de la date, de l'heure et du fuseau horaire du téléphone. Le format est le suivant : YYYY:MM:DD HH:MM:SS+(-)HH:MM. L'heure est au format 24 heures, la date et l'heure étant séparées par un espace, Le fuseau horaire est un décalage par rapport à l'heure UTC. Par exemple, 2014:05:18 01:04:29+8:00 correspond au fuseau horaire de la Chine (UTC+8:00). rw
hdr

Niveau d'API 1:booléen

Niveau d'API 2:chaîne

Niveau d'API 1:active/désactive le mode de capture HDR. La valeur est true pour activer le HDR ou false pour le désactiver. La valeur par défaut est false. Le paramètre ne peut être true que si hdrSupport est également true.

Niveau d'API 2:mode HDR actuel du type "Chaîne".

Cette option a été modifiée au niveau d'API 2.

 rw
hdrSupport

Niveau d'API 1:booléen

Niveau d'API 2:tableau de chaînes

Niveau d'API 1:la valeur true signifie que l'appareil photo est compatible avec le format HDR. Le paramètre false identifie une caméra sans HDR.

Niveau d'API 2:si le mode HDR n'est pas disponible, il est [“off”]; si vous n'acceptez qu'un seul mode HDR, la valeur [“off”, “hdr”] est définie. Si plusieurs modes HDR (basés sur différents algorithmes) sont compatibles, la valeur est [“off”, “hdr”, “hdr1”, “hdr2”, ...].

Cette option a été modifiée au niveau d'API 2.

 r
exposureBracket Objet Réglage actuel du contraste d'exposition. Disponible uniquement lorsque hdrSupport == true (niveau d'API 1) ou hdrSupport contient au moins un mode HDR (niveau d'API 2). Si l'appareil photo utilise le balisage d'exposition manuel, l'objet contient deux entrées: <ph type="x-smartling-placeholder">
    </ph>
  1. shots, un nombre entier contenant le nombre de prises de vue à prendre.
  2. increment, un nombre indiquant un incrément VE entre les prises de vue.
Exemple: 
{
    "shots": 3,
    "increment": 1.33
}
Si l'appareil photo utilise le balisage d'exposition automatique, l'objet contient: 
{
    "autoMode": true
}

Niveau d'API 1:{} est vide par défaut lorsque hdrSupport == false. Les fabricants décident des valeurs par défaut (par exemple, le partitionnement de l'exposition automatique) lorsque hdr est défini sur true.

Niveau d'API 2:le champ {} est vide par défaut lorsque hdrSupport ne contient que "off". Sinon, les fabricants décident des valeurs par défaut (par exemple, le balisage d'exposition automatique).

Cette option a été modifiée au niveau d'API 2.

 rw
exposureBracketSupport Objet

Les paramètres du contraste d'exposition sont actuellement disponibles. Par exemple:

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

Niveau d'API 1:{} est vide par défaut si hdrSupport == false. Lorsque la valeur est hdrSupport == true, mais que le partitionnement d'exposition automatique n'est pas disponible, autoMode est défini sur false.

Niveau d'API 2:{} est vide par défaut si hdrSupport ne contient que "off". Lorsque hdrSupport contient un mode HDR, mais que le partitionnement d'exposition automatique n'est pas disponible, autoMode est défini sur false.

Cette option a été modifiée au niveau d'API 2.

 r
gyro Booléen Définissez la valeur sur true pour activer le module du gyroscope de la caméra ou sur false pour désactiver cette fonctionnalité. Définissez la valeur par défaut sur true si l'appareil photo le permet, ou sur false. Ce paramètre ne peut être défini que sur true lorsque gyroSupport == true. rw
gyroSupport Booléen Si la caméra est équipée d'un gyroscope, cette valeur doit être true. Sinon, elle doit être false. r
gps Booléen Active/Désactive le module GPS de la caméra. La valeur doit être true pour l'activer ou false pour la désactiver. La valeur par défaut est true si l'appareil photo le permet. Sinon, false. Le paramètre est défini sur true uniquement lorsque gpsSupport == true. rw
gpsSupport Booléen Cette valeur doit être true si l'appareil photo dispose de son propre module GPS. Sinon, il doit être défini sur false. r
imageStabilization Chaîne Opération en cours de stabilisation de l'image Exemple : off. rw
imageStabilizationSupport Tableau de chaînes Options de stabilisation de l'image actuellement disponibles. La liste prédéfinie est ["off", "on"]. Si l'appareil photo n'est pas compatible avec la stabilisation de l'image, renvoyez ["off"]. Sinon, renvoyez ["off", "on"]. Ajoutez un trait de soulignement ( _ ) aux chaînes spécifiques au fournisseur en préfixe. Exemple : [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword Chaîne
Au moins huit caractères, avec des lettres, des chiffres et des symboles, mais sans espaces. Ce paramètre ne peut être modifié que lorsque la caméra est connectée à un appareil client. Une fois le paramètre modifié, la caméra doit se déconnecter pour que l'utilisateur se reconnecte à l'aide du nouveau wifiPassword.
La caméra doit fournir un mécanisme de réinitialisation en cas d'oubli du mot de passe. par exemple, un bouton de réinitialisation pour restaurer le mot de passe par défaut.
 w
previewFormat Objet

Résolution actuelle de l'aperçu en direct Par exemple:

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

Cette option a été ajoutée au niveau d'API 2.

 rw
previewFormatSupport Tableau d'objets

Formats d'aperçu en direct actuellement compatibles Par exemple:

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

Cette option a été ajoutée au niveau d'API 2.

 r
captureInterval Nombre Intervalle actuel entre la capture de deux images consécutives, dans seconds.

Cette option a été ajoutée au niveau d'API 2.

 rw
captureIntervalSupport Objet

Intervalles minimal et maximal autorisés entre la capture de deux images consécutives, en secondes Par exemple:

{
    "minInterval": 10,
    "maxInterval": 60
}
Cela peut varier en fonction de fileFormat.

Cette option a été ajoutée au niveau d'API 2.

 r
captureNumber Nombre Nombre d'images à capturer pour une session de capture par intervalles. La valeur par défaut est 0, ce qui signifie que la capture doit être arrêtée explicitement par la commande stopCapture. Sinon, la capture s'arrête automatiquement après la capture d'images du nombre spécifié. La capture peut également être interrompue lorsque la caméra est déchargée ou lorsqu'elle est éteinte intentionnellement.

Cette option a été ajoutée au niveau d'API 2.

 rw
captureNumberSupport Objet

Nombre minimal et maximal d'images pouvant être capturées au cours d'une capture par intervalles Par exemple:

{
    "minNumber": 2,
    "maxNumber": 50
}
Il peut changer en fonction de l'espace de stockage restant.

Cette option a été ajoutée au niveau d'API 2.

 r
remainingVideoSeconds Nombre Nombre estimé de seconds pour la vidéo restante en fonction du paramètre d'enregistrement actuel.

Cette option a été ajoutée au niveau d'API 2.

 r
pollingDelay Nombre Intervalle minimal en secondes entre deux requêtes consécutives d'interrogation d'état. Les clients doivent utiliser ce champ pour guider leur processus de sondage de statut. Par exemple, lors de l'assemblage d'une image, les clients devront peut-être interroger régulièrement l'appareil photo pour voir si l'assemblage est terminé. La prise en charge varie selon les caméras. Par exemple, certaines caméras peuvent gérer l'interrogation de l'état toutes les secondes, tandis que d'autres acceptent un intervalle plus long.

Cette option a été ajoutée au niveau d'API 2.

 r
delayProcessing Booléen True lors du traitement (un assemblage, par exemple) a une priorité inférieure à celle de la capture. En d'autres termes, une autre capture est autorisée avant la fin du traitement de l'image capturée précédente. Cette configuration est vivement recommandée, en particulier pour les caméras dont le traitement est long.

Cette option a été ajoutée au niveau d'API 2.

 rw
delayProcessingSupport Tableau booléen

[true] signifie que le traitement (un assemblage, par exemple) a une priorité inférieure à celle de la capture et qu'il est toujours retardé par défaut.

[false] signifie que le traitement a lieu juste après la capture.

[true, false] signifie qu'il est possible de choisir entre ces deux modes.

Cette option a été ajoutée au niveau d'API 2.

 r
clientVersion Nombre

Niveau d'API que le client décide d'utiliser. La valeur par défaut est 1 si la est compatible avec les niveaux d'API 1 et 2, ce qui permet aux clients Le niveau d'API 1 fonctionne toujours avec l'appareil photo sans aucune modification. par défaut sur 2 si l'appareil photo n'est compatible qu'avec le niveau d'API 2, qui n'est pas recommandé avant la migration des clients vers le niveau d'API 2. Si la caméra ne prend en charge que le niveau d'API 2, la requête qui tente de le définir sur 1 doit échouer. Si clientVersion est défini correctement sur 2 et qu'une d'API obsolète de niveau 1 est demandée, la requête doit échouer avec le code d'erreur unknownCommand.

Cette option a été ajoutée au niveau d'API 2.

 rw
photoStitchingSupport Tableau de chaînes

Liste des options d'assemblage pour les photos. Retour [ondevice] si les photos sont toujours assemblées sur l'appareil photo, [none] si l'appareil photo ne parvient pas à assembler les photos ; et [none,ondevice] si l'assemblage est configurable par l'utilisateur. Ajoutez un trait de soulignement aux noms de paramètres spécifiques au fournisseur, par exemple _vendor-setting

Cette option a été ajoutée au niveau d'API 2.1.

 r
photoStitching Chaîne

Option d'assemblage actuelle pour les photos, par exemple ondevice Valeur par défaut : ondevice si c'est le cas compatibles.

Cette option a été ajoutée au niveau d'API 2.1.

 rw
videoStitchingSupport Tableau de chaînes

Liste des options d'assemblage pour les vidéos. Retour [ondevice] si les vidéos sont toujours assemblées par la caméra, [none] si la caméra ne parvient pas à assembler les vidéos ; et [none,ondevice] si l'assemblage est configurable par l'utilisateur. Ajoutez un trait de soulignement aux noms de paramètres spécifiques au fournisseur, par exemple _vendor-setting

Cette option a été ajoutée au niveau d'API 2.1.

 r
videoStitching Chaîne

Option d'assemblage actuelle pour les vidéos, par exemple ondevice Valeur par défaut : ondevice si c'est le cas compatibles.

Cette option a été ajoutée au niveau d'API 2.1.

 rw
videoGPSSupport Tableau de chaînes

Liste des options GPS pendant l'enregistrement vidéo. Retour [continuous] si l'appareil photo peut capturer le GPS en continu pendant la capture vidéo et intégrer les lieux dans la vidéo. Retour [none] si ce n'est pas le cas et [none,continuous] si la prise en charge vidéo GPS est configurable par l'utilisateur. Préfixe spécifique au fournisseur les noms de paramètres précédés d'un trait de soulignement, par exemple _vendor-setting

Cette option a été ajoutée au niveau d'API 2.1.

 r
videoGPS Chaîne

Option actuelle de prise en charge GPS lors de l'enregistrement vidéo, par ex. continuous Valeur par défaut : continuous si c'est le cas compatibles.

Cette option a été ajoutée au niveau d'API 2.1.

 rw
_vendorSpecific [type] (facultatif) Options de caméra supplémentaires propres au fournisseur Ajoutez le préfixe des chaînes spécifiques au fournisseur un trait de soulignement ( _ ).