captureImage (Client-API-Referenz)
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. Zeichenfolge- 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