Freigeben über

captureImage (Client-API-Referenz)

  • Artikel

Ruft die Gerätekamera auf, um ein Bild zu erfassen.

Verfügbar für

Diese Methode wird nur für mobile Clients unterstützt.

Syntax

Xrm.Device.captureImage(imageOptions).then(successCallback, errorCallback)

Parameter

Parametername Type Erforderlich Beschreibung
imageOptions Object Nein Ein Objekt mit den folgenden Werten:
- allowEdit: Gibt an, ob das Bild vor dem Speichern zu bearbeiten ist. Boolesch.
- quality: Qualität der Bilddatei in Prozent. Nummer.
- height: Höhe des zu erfassenden Bilds. Nummer.
- width: Breite des zu erfassenden Bilds. Nummer.
Hinweis: Bei Verwendung müssen sowohl die Höhen- als auch die Breitenabmessungen angegeben werden.
successCallback Function Ja Eine Funktion, die bei der Rückgabe des Bilds aufgerufen wird. Ein Base64-codiertes Bildobjekt mit den folgenden Werten wird an die Funktion übergeben:
- fileContent: Inhalt der Bilddatei. String
- fileName: Name der Bilddatei. Zeichenfolge.
- fileSize: Größe der Bilddatei in KB. Nummer.
- mimeType: Bilddatei-MIME-Typ. Zeichenfolge.
errorCallback Function Ja Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Gibt bei Erfolg ein base64-codiertes Bildobjekt mit den zuvor angegebenen Werten zurück.

Ausnahmen

Siehe Webdienst-Fehlercodes

Xrm.Device

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).