cordova-plugin-camera/doc/fr/index.md

org.apache.cordova.camera

Ce plugin fournit une API pour la prise de photos et de choisir des images de la bibliothèque d'images du système.

cordova plugin add org.apache.cordova.camera

navigator.camera.getPicture

Prend une photo à l'aide de la caméra, ou récupère une photo de la Galerie d'images de l'appareil. L'image est passée au callback "succès" comme une String encodée en base64 ou l'URI du fichier de l'image. La méthode elle-même renvoie un objet CameraPopoverHandle qui permet de repositionner la boite de dialogue de selection d'image.

navigator.camera.getPicture( cameraSuccess, cameraError, cameraOptions );

Description

La fonction camera.getPicture ouvre l'application par défaut de l'appareil qui permet aux utilisateurs de prendre des photos. Ce comportement se produit par défaut, lorsque Camera.sourceType est égal à Camera.PictureSourceType.CAMERA. Une fois que l'utilisateur a pris la photo, l'application "camera" se ferme et l'application est restaurée.

Si Camera.sourceType est Camera.PictureSourceType.PHOTOLIBRARY ou Camera.PictureSourceType.SAVEDPHOTOALBUM, alors une boîte de dialogue s'affiche pour permettre aux utilisateurs de sélectionner une image existante. La fonction camera.getPicture retourne un objet CameraPopoverHandle qui permet de repositionner le dialogue de sélection d'image, par exemple, lorsque l'orientation de l'appareil change.

La valeur de retour est envoyée à la fonction callback cameraSuccess, dans l'un des formats suivants, selon spécifié par cameraOptions :

• A String contenant l'image photo codée en base64.

• A String qui représente l'emplacement du fichier image sur le stockage local (par défaut).

Vous pouvez faire ce que vous voulez avec l'image encodée ou l'URI, par exemple :

• Afficher l'image dans un <img> tag, comme dans l'exemple ci-dessous

• Enregistrer les données localement ( LocalStorage , poids, etc..)

• Publier les données sur un serveur distant

NOTE: la résolution de Photo sur les nouveaux appareils est assez bonne. Les photos sélectionnées de la Galerie de l'appareil ne sont pas réduites avec une baisse de la qualité, même si un paramètre de qualité est spécifié. Pour éviter les problèmes de mémoire, définissez Camera.destinationType à FILE_URI plutôt que DATA_URL.

Plates-formes prises en charge

• Amazon Fire OS
• Android
• BlackBerry 10
• Firefox OS
• iOS
• Paciarelli
• Windows Phone 7 et 8
• Windows 8

Amazon Fire OS Quirks

Amazon Fire OS utilise des intentions pour lancer l'activité de l'appareil photo sur l'appareil pour capturer des images et sur les téléphones avec peu de mémoire, l'activité de Cordova peut être tuée. Dans ce scénario, l'image peut ne pas apparaître lorsque l'activité de cordova est restaurée.

Spécificités Android

Android utilise des intentions pour lancer l'activité de l'appareil photo sur l'appareil pour capturer des images et sur les téléphones avec peu de mémoire, l'activité de Cordova peut être tuée. Dans ce scénario, l'image peut ne pas apparaître lorsque l'activité de Cordova est restaurée.

Firefox OS Quirks

Appareil photo plugin est actuellement mis en œuvre à l'aide d'Activités sur le Web.

iOS Quirks

Y compris un JavaScript alert() dans les deux le rappel fonctions peuvent causer des problèmes. Envelopper l'alerte dans un setTimeout() pour permettre le sélecteur d'image iOS ou kangourou pour fermer entièrement avant que l'alerte s'affiche :

setTimeout(function() {/ / votre code ici!}, 0) ;

Spécificités Windows Phone 7

Invoquant l'application native caméra alors que l'appareil est connecté via Zune ne fonctionne pas et déclenche un rappel de l'erreur.

Spécificités Tizen

Paciarelli prend uniquement en charge un destinationType de Camera.DestinationType.FILE_URI et un sourceType deCamera.PictureSourceType.PHOTOLIBRARY.

Exemple

Prendre une photo, puis extrayez-la comme une image codée en base64 :

navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
    destinationType: Camera.DestinationType.DATA_URL
});

function onSuccess(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

function onFail(message) {
    alert('Failed because: ' + message);
}

Prendre une photo et récupérer l'emplacement du fichier de l'image :

navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
    destinationType: Camera.DestinationType.FILE_URI });

function onSuccess(imageURI) {
    var image = document.getElementById('myImage');
    image.src = imageURI;
}

function onFail(message) {
    alert('Failed because: ' + message);
}

CameraOptions

Paramètres optionnels pour personnaliser les réglages de l'appareil.

{ quality : 75,
  destinationType : Camera.DestinationType.DATA_URL,
  sourceType : Camera.PictureSourceType.CAMERA,
  allowEdit : true,
  encodingType: Camera.EncodingType.JPEG,
  targetWidth: 100,
  targetHeight: 100,
  popoverOptions: CameraPopoverOptions,
  saveToPhotoAlbum: false };

Options

• quality : Qualité de l'image enregistrée, comprise entre 0 et 100, où 100 correspond à la pleine résolution de l'appareil, sans perte liée à la compression. La valeur par défaut est 50. (Nombre) (Notez que les informations sur la résolution de la caméra sont indisponibles).

• destinationType: choisissez le format de la valeur de retour. La valeur par défaut est FILE_URI. Définies dans navigator.camera.DestinationType (nombre)

  Camera.DestinationType = {
      DATA_URL : 0,      // Retourne l'image sous la forme d'une chaîne encodée en base-64
      FILE_URI : 1,      // Retourne l'URI du fichier image
      NATIVE_URI : 2     // Retourne l'URI native de l'image (ex. assets-library:// sur iOS ou content:// pour Android)
  };
  

• sourceType: définissez la source de l'image. La valeur par défaut est la caméra. Définies dans navigator.camera.PictureSourceType (nombre)

  Camera.PictureSourceType = {
      PHOTOLIBRARY : 0,
      CAMERA : 1,
      SAVEDPHOTOALBUM : 2
  };
  

• allowEdit: Autoriser une modification simple de l'image avant sa sélection. (Boolean)

• encodingType: choisir le fichier image retournée de codage. Valeur par défaut est JPEG. Définies dans navigator.camera.EncodingType (nombre)

  Camera.EncodingType = {
      JPEG : 0,               // Renvoie l'image au format JPEG
      PNG : 1                 // Renvoie l'image au format PNG
  };
  

• targetWidth: largeur de sortie en pixels de l'image . Doit être utilisé avec targetHeight. Le ratio de l'aspect reste constant. (Nombre)

• targetHeight: hauteur de sortie en pixels de l'image. Doit être utilisé avec targetWidth. Aspect ratio reste constant. (Nombre)

• mediaType: définit le type de média à choisir. Ne fonctionne que quand PictureSourceType vaut PHOTOLIBRARY ou SAVEDPHOTOALBUM . Définie dans nagivator.camera.MediaType (nombre)

  Camera.MediaType = {photo: 0, / / permettre la sélection de photos seulement. PAR DÉFAUT. Will return format specified via DestinationType
      VIDEO: 1,      // allow selection of video only, WILL ALWAYS RETURN FILE_URI
      ALLMEDIA : 2   // allow selection from all media types
  };
  

• correctOrientation: faire pivoter l'image afin de corriger l'orientation de l'appareil lors de la capture. (Booléen)

• saveToPhotoAlbum: enregistrer l'image sur l'album photo sur l'appareil après la capture. (Booléen)

• popoverOptions: options pour iOS uniquement qui spécifient l'emplacement de la boîte de dialogue sur iPad. Définie dansCameraPopoverOptions.

• cameraDirection: choisissez la caméra à utiliser (ou dos-face). La valeur par défaut est de retour. Définies dans navigator.camera.Direction (nombre)

  Camera.Direction = {BACK: 0, // utiliser la caméra arrière FRONT: 1 // utiliser la caméra frontale} ;
  

Amazon Fire OSQuirks

• Tout cameraDirection résultats dans le back-face photo de valeur.

• Ignore le paramètre allowEdit.

• Camera.PictureSourceType.PHOTOLIBRARYet Camera.PictureSourceType.SAVEDPHOTOALBUM les deux affichent le même album photo.

Quirks Android

• Tout cameraDirection résultats dans le back-face photo de valeur.

• Ignore la allowEdit paramètre.

• Camera.PictureSourceType.PHOTOLIBRARYet Camera.PictureSourceType.SAVEDPHOTOALBUM les deux affichent le même album photo.

BlackBerry 10 Quirks

• Ignore le paramètre quality.

• Ignore le paramètre sourceType.

• Ignore la allowEdit paramètre.

• Camera.MediaType n'est pas pris en charge.

• Ignore le paramètre correctOrientation.

• Ignore le paramètre cameraDirection.

Firefox OS Quirks

• Ignore la quality paramètre.

• Camera.DestinationTypeest ignorée et est égal à 1 (URI du fichier image)

• Ignore la allowEdit paramètre.

• Ignore la PictureSourceType paramètre (utilisateur il choisit dans une fenêtre de dialogue)

• Ignore leencodingType

• Ignore la targetWidth ettargetHeight

• Camera.MediaTypen'est pas pris en charge.

• Ignore la correctOrientation paramètre.

• Ignore la cameraDirection paramètre.

iOS Quirks

• Choisir la valeur quality en dessous de 50 pour éviter les erreurs de mémoire sur certains appareils.

• Lorsque vous utilisez destinationType.FILE_URI , les photos sont sauvegardées dans le répertoire temporaire de l'application. Le contenu du répertoire temporaire de l'application est supprimé lorsque l'application se termine.

Bizarreries de paciarelli

• options non prises en charge

• retourne toujours un URI de fichier

Windows Phone 7 et 8 Quirks

• Ignore la allowEdit paramètre.

• Ignore la correctOrientation paramètre.

• Ignore la cameraDirection paramètre.

• Ignore la saveToPhotoAlbum paramètre. IMPORTANT : Toutes les images prises avec la caméra de cordova wp7/8 API sont toujours copiés au rôle d'appareil photo du téléphone. Selon les paramètres de l'utilisateur, cela pourrait également signifier que l'image est auto-téléchargées à leur OneDrive. Potentiellement, cela pourrait signifier que l'image est disponible à un public plus large que votre application destinée. Si ce un bloqueur pour votre application, vous devrez implémenter le CameraCaptureTask tel que documenté sur msdn : http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx vous pouvez aussi commenter ou haut-vote la question connexe dans le gestionnaire d'incidents

• Ignore la mediaType propriété de cameraOptions comme le kit de développement Windows Phone ne fournit pas un moyen de choisir les vidéos de PHOTOLIBRARY.

CameraError

fonction de rappel onError qui fournit un message d'erreur.

function(message) {
    // Show a helpful message
}

Paramètres

• message : le message est fourni par du code natif de l'appareil. (String)

cameraSuccess

fonction de rappel onSuccess qui fournit les données d'image.

function(imageData) {
    // Do something with the image
}

Paramètres

• imageData: codage Base64 de l'image, ou le fichier image URI, selon cameraOptions utilisé. (String)

Exemple

// Show image
//
function cameraCallback(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

CameraPopoverHandle

Un handle vers la boîte de dialogue de kangourou créé parnavigator.camera.getPicture.

Méthodes

• setPosition: Définit la position de la boite de dialogue.

Plates-formes prises en charge

• iOS

setPosition

Définir la position de la kangourou.

Paramètres:

• cameraPopoverOptions: l'objet CameraPopoverOptions spécifiant la nouvelle position

Exemple

 var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
     { destinationType: Camera.DestinationType.FILE_URI,
       sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
       popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
     });

 // Reposition the popover if the orientation changes.
 window.onorientationchange = function() {
     var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
     cameraPopoverHandle.setPosition(cameraPopoverOptions);
 }

CameraPopoverOptions

iOS uniquement les paramètres qui spécifient la direction ancre élément emplacement et de la flèche de la kangourou lors de la sélection des images de la bibliothèque de l'iPad ou l'album.

{ x : 0, y :  32, width : 320, height : 480, arrowDir : Camera.PopoverArrowDirection.ARROW_ANY };

CameraPopoverOptions

• x: coordonnée en x (pixels) de l'élément à l'écran sur lequel accrocher la boite de dialogue. (Number)

• y: coordonnée en y (pixels) de l'élément à l'écran sur lequel accrocher la boite de dialogue. (Number)

• width: largeur en pixels de l'élément à l'écran sur lequel accrocher la boite de dialogue. (Number)

• height: hauteur en pixels de l'élément à l'écran sur lequel accrocher la boite de dialogue. (Number)

• arrowDir: Direction vers laquelle la flèche de la boîte de dialogue doit pointer. Définie dans Camera.PopoverArrowDirection (Number)

      Camera.PopoverArrowDirection = {
          ARROW_UP : 1,        // correspondent aux constantes iOS UIPopoverArrowDirection
          ARROW_DOWN : 2,
          ARROW_LEFT : 4,
          ARROW_RIGHT : 8,
          ARROW_ANY : 15
      };
  

Notez que la taille de la kangourou peut changer pour s'adapter à la direction de la flèche et l'orientation de l'écran. Assurez-vous que tenir compte des changements d'orientation lors de la spécification de l'emplacement d'élément d'ancrage.

Navigator.Camera.Cleanup

Supprime les intermédiaires photos prises par la caméra de stockage temporaire.

navigator.camera.cleanup( cameraSuccess, cameraError );

Description

Supprime les intermédiaires les fichiers image qui sont gardées en dépôt temporaire après avoir appelé camera.getPicture . S'applique uniquement lorsque la valeur de Camera.sourceType est égale à Camera.PictureSourceType.CAMERA et le Camera.destinationType est égal àCamera.DestinationType.FILE_URI.

Plates-formes prises en charge

• iOS

Exemple

navigator.camera.cleanup(onSuccess, onFail);

function onSuccess() {
    console.log("Camera cleanup success.")
}

function onFail(message) {
    alert('Failed because: ' + message);
}