Dieses Plugin ermöglicht den Zugriff auf des Geräts Audio-, Bild- und video-Capture-Funktionen.
Warnung: Erfassung und Verwendung von Bildern, Video oder Audio von Kamera oder das Mikrofon des Geräts wirft wichtige Privatsphäre Fragen. Ihre app-Datenschutzerklärung sollten besprechen, wie die app solche Sensoren verwendet und ob die aufgezeichneten Daten mit irgendwelchen anderen Parteien geteilt werden. Zusätzlich wenn die app-Nutzung der Kamera oder Mikrofon in der Benutzeroberfläche nicht offensichtlich ist, sollten Sie eine just-in-Time Ihnen vorher die app die Kamera oder das Mikrofon zugreift (wenn das Betriebssystem des Geräts bereits tun nicht). Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das OK und Nein danke). Beachten Sie, dass einige app-Marktplätze können Ihre app eine Frist von just-in-Time und Erlaubnis des Benutzers vor dem Zugriff auf die Kamera oder das Mikrofon einholen. Weitere Informationen finden Sie in der Datenschutz-Guide.
Dieses Plugin wird global navigator.device.capture-Objekt definiert.
Obwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem deviceready-Ereignis.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.device.capture);
}
cordova plugin add cordova-plugin-media-capture
SupportedAudioModes: die Audio-Aufnahme vom Gerät unterstützten Formate. (ConfigurationData[])
SupportedImageModes: die Aufnahme Bildgrößen und Formaten, die von dem Gerät unterstützt. (ConfigurationData[])
SupportedVideoModes: die Aufnahme Bildschirmauflösungen und Formate, die vom Gerät unterstützt. (ConfigurationData[])
Die audio-Recorder-Anwendung starten und geben Informationen über aufgenommene audio-Clip-Dateien zurück.
navigator.device.capture.captureAudio(
CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureAudioOptions options]
);
Beginnt einen asynchronen Vorgang, Audioaufnahmen, die audio-Aufnahme-Standardanwendung des Geräts erfassen. Die Operation erlaubt dem Benutzer des Geräts, mehrere Aufnahmen in einer einzigen Sitzung zu erfassen.
Der Capture-Vorgang endet, wenn entweder der Benutzer schließt die Anwendung für die Audioaufnahme, oder die maximale Anzahl der Aufnahmen, die von CaptureAudioOptions.limit angegebene erreicht ist. Wenn kein Grenzwert für den Parameter angegeben ist, wird standardmaessig eins (1) und der Capture-Vorgang beendet, nachdem der Benutzer ein einzelnes audio-Clips aufgezeichnet.
Wenn der Capture-Vorgang abgeschlossen ist, führt die CaptureCallback mit einem Array von MediaFile Objekten beschreibt jede aufgezeichnete audio-Clip-Datei. Wenn der Benutzer den Vorgang beendet wird, bevor ein Audioclip erfasst wird, führt die CaptureErrorCallback mit einem CaptureError-Objekt, mit dem Fehlercode CaptureError.CAPTURE_NO_MEDIA_FILES.
// capture callback
var captureSuccess = function(mediaFiles) {
var i, path, len;
for (i = 0, len = mediaFiles.length; i < len; i += 1) {
path = mediaFiles[i].fullPath;
// do something interesting with the file
}
};
// capture error callback
var captureError = function(error) {
navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};
// start audio capture
navigator.device.capture.captureAudio(captureSuccess, captureError, {limit:2});
Kapselt Audioaufnahme-Konfigurationsoptionen.
Limit: die maximale Anzahl von audio-Clips kann Benutzer des Geräts in einem einzigen Capture-Vorgang aufzeichnen. Der Wert muss größer als oder gleich 1 (Standardwert 1).
Dauer: die maximale Dauer eines audio-sound-Clips, in Sekunden.
// limit capture operation to 3 media files, no longer than 10 seconds each
var options = { limit: 3, duration: 10 };
navigator.device.capture.captureAudio(captureSuccess, captureError, options);
duration Parameter wird nicht unterstützt. Aufnahme Längen kann nicht programmgesteuert begrenzt.duration Parameter wird nicht unterstützt. Aufnahme Längen kann nicht programmgesteuert begrenzt.duration Parameter wird nicht unterstützt. Aufnahme Längen kann nicht programmgesteuert begrenzt.limit Parameter wird nicht unterstützt, kann also nur eine Aufnahme für jeden Aufruf erstellt werden.limit Parameter wird nicht unterstützt, kann also nur eine Aufnahme für jeden Aufruf erstellt werden.Starten Sie die Kameraanwendung und geben Informationen über aufgenommene Bild-Dateien zurück.
navigator.device.capture.captureImage(
CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions options]
);
Beginnt einen asynchronen Vorgang, um Aufnahmen mit Kamera-Anwendung des Geräts. Die Operation erlaubt Benutzern, mehr als ein Bild in einer einzigen Sitzung zu erfassen.
Die Capture Betrieb endet, wenn der Benutzer schließt die Kameraanwendung oder die maximale Anzahl der Aufnahmen, die durch CaptureAudioOptions.limit angegeben ist erreicht. Wenn kein Grenzwert angegeben ist, wird eins (1 standardmaessig) und der Capture-Vorgang beendet nach fängt der Benutzer ein einzelnes Bild.
Wenn der Capture-Vorgang abgeschlossen ist, ruft es den CaptureCB-Rückruf mit einem Array von MediaFile Objekten beschreibt jede aufgenommene Bild-Datei. Wenn der Benutzer den Vorgang vor dem Aufzeichnen eines Abbilds beendet wird, führt der CaptureErrorCB-Rückruf mit einem CaptureError-Objekt mit einem CaptureError.CAPTURE_NO_MEDIA_FILES-Fehlercode.
Die native Kameraanwendung aufrufen, während Ihr Gerät via Zune angeschlossen ist, funktioniert nicht, und die Fehler-Callback führt.
Arbeitet in Chrome, Firefox und Opera nur (da IE und Safari nicht unterstützt navigator.getUserMedia-API)
Anzeigen von Bildern mit erfasst nur Datei-URL in Chrome/Opera verfügbar. Firefox speichert die aufgenommenen Bilder in IndexedDB Speicher (siehe Datei-Plugin-Dokumentation), und aus diesem Grund ist die einzige Möglichkeit, aufgenommene Bild zeigen es und zeigen mit ihrer DataURL lesen.
// capture callback
var captureSuccess = function(mediaFiles) {
var i, path, len;
for (i = 0, len = mediaFiles.length; i < len; i += 1) {
path = mediaFiles[i].fullPath;
// do something interesting with the file
}
};
// capture error callback
var captureError = function(error) {
navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};
// start image capture
navigator.device.capture.captureImage(captureSuccess, captureError, {limit:2});
Image Capture-Konfigurationsoptionen kapselt.
// limit capture operation to 3 images
var options = { limit: 3 };
navigator.device.capture.captureImage(captureSuccess, captureError, options);
Die Videorecorder-Anwendung starten und geben Informationen zu aufgezeichneten video-Clip-Dateien zurück.
navigator.device.capture.captureVideo(
CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions options]
);
Beginnt einen asynchronen Vorgang um Videoaufnahmen mit Videoaufzeichnung-Anwendung des Geräts zu erfassen. Die Operation ermöglicht dem Benutzer, mehrere Aufnahmen in einer einzigen Sitzung zu erfassen.
Der Capture-Vorgang endet, wenn entweder der Benutzer schließt die Anwendung für die Audioaufnahme, oder die maximale Anzahl der Aufnahmen, die von CaptureAudioOptions.limit angegebene erreicht ist. Wenn kein Grenzwert für den Parameter angegeben ist, wird standardmaessig eins (1) und der Capture-Vorgang beendet, nachdem der Benutzer einen einzelnen video Clip aufgezeichnet.
Der Capture-Vorgang abgeschlossen ist, führt er der CaptureCB-Rückruf mit einem Array von MediaFile Objekten beschreibt jede aufgezeichnete video-Clip-Datei. Wenn der Benutzer den Vorgang vor dem Erfassen eines Videoclips beendet wird, führt der CaptureErrorCB-Rückruf mit einem CaptureError-Objekt mit einem CaptureError.CAPTURE_NO_MEDIA_FILES-Fehlercode.
// capture callback
var captureSuccess = function(mediaFiles) {
var i, path, len;
for (i = 0, len = mediaFiles.length; i < len; i += 1) {
path = mediaFiles[i].fullPath;
// do something interesting with the file
}
};
// capture error callback
var captureError = function(error) {
navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};
// start video capture
navigator.device.capture.captureVideo(captureSuccess, captureError, {limit:2});
CaptureError.CAPTURE_NOT_SUPPORTED Fehlercode, wenn die Anwendung nicht auf dem Gerät installiert ist.Video-Capture-Konfigurationsoptionen kapselt.
Limit: die maximale Anzahl von video-Clips des Geräts Benutzer kann in einem einzigen Capture-Vorgang erfassen. Der Wert muss größer als oder gleich 1 (Standardwert 1).
Dauer: die maximale Dauer eines Videoclips in Sekunden.
// limit capture operation to 3 video clips
var options = { limit: 3 };
navigator.device.capture.captureVideo(captureSuccess, captureError, options);
Auf eine erfolgreiche Media-Erfassungsvorgangs aufgerufen.
function captureSuccess( MediaFile[] mediaFiles ) { ... };
Diese Funktion wird ausgeführt, nachdem ein erfolgreiche Capture-Vorgang abgeschlossen ist. An diesem Punkt kann eine Mediendatei erfasst wurden und entweder der Benutzer die Medien-Capture-Anwendung beendet hat oder die Capture-erreicht.
Jedes MediaFile-Objekt beschreibt eine aufgenommenen Medien-Datei.
// capture callback
function captureSuccess(mediaFiles) {
var i, path, len;
for (i = 0, len = mediaFiles.length; i < len; i += 1) {
path = mediaFiles[i].fullPath;
// do something interesting with the file
}
};
Kapselt den Fehlercode, der infolge eines fehlerhaften Medien-Erfassungsvorgangs.
CaptureError.CAPTURE_INTERNAL_ERR: Die Kamera oder das Mikrofon konnte Bild oder Ton zu erfassen.
CaptureError.CAPTURE_APPLICATION_BUSY: Eine weitere Aufnahme-Anforderung verbüßt die Kamera oder Audio-Capture-Anwendung.
CaptureError.CAPTURE_INVALID_ARGUMENT: Ungültige Verwendung der API (z. B. den Wert des limit ist kleiner als 1).
CaptureError.CAPTURE_NO_MEDIA_FILES: Der Benutzer wird die Kamera oder Audio-Capture-Anwendung vor Aufnahme alles beendet.
CaptureError.CAPTURE_NOT_SUPPORTED: Der angeforderte Capture-Vorgang wird nicht unterstützt.
Wird aufgerufen, wenn ein Fehler, während eines Medien auftritt.
function captureError( CaptureError error ) { ... };
Diese Funktion wird ausgeführt, wenn ein Fehler auftritt, wenn Sie versuchen, starten Sie ein Medium capture Betrieb. Fehlerszenarien enthalten, wenn die Sicherungsanwendung beschäftigt, ein Capture-Vorgang ist bereits im Gange, oder der Benutzer den Vorgang abbricht, bevor alle Mediendateien erfasst werden.
Diese Funktion führt mit einem CaptureError-Objekt enthält einen entsprechenden Fehler-code.
// capture error callback
var captureError = function(error) {
navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};
Kapselt eine Reihe von Medien-Aufnahme-Parameter, die ein Gerät unterstützt.
Beschreibt Medien-Aufnahmemodi, die vom Gerät unterstützt. Die Konfigurationsdaten enthält den MIME-Typ und Capture Dimensionen für die Aufnahme von Video- oder Bilddateien.
Die MIME-Typen sollten RFC2046 einhalten. Beispiele:
video/3gppvideo/quicktimeimage/jpegaudio/amraudio/wavTyp: die ASCII-codierte Zeichenfolge aus Kleinbuchstaben, den Medientyp darstellt. (DOM-String und enthält)
Höhe: die Höhe des Bildes oder Videos in Pixel. Der Wert ist NULL für sound-Clips. (Anzahl)
Breite: die Breite des Bildes oder Videos in Pixel. Der Wert ist NULL für sound-Clips. (Anzahl)
// retrieve supported image modes
var imageModes = navigator.device.capture.supportedImageModes;
// Select mode that has the highest horizontal resolution
var width = 0;
var selectedmode;
for each (var mode in imageModes) {
if (mode.width > width) {
width = mode.width;
selectedmode = mode;
}
}
Von jeder Plattform unterstützt nicht. Alle Konfigurations-Daten-Arrays sind leer.
Ruft formatieren Informationen über die Medien-Capture-Datei.
mediaFile.getFormatData(
MediaFileDataSuccessCB successCallback,
[MediaFileDataErrorCB errorCallback]
);
Diese Funktion versucht asynchron, die Formatierungsinformationen für die Mediendatei abzurufen. Wenn erfolgreich, wird den MediaFileDataSuccessCB-Rückruf mit einem MediaFileData-Objekt. Wenn dieser Versuch fehlschlägt, ruft diese Funktion den MediaFileDataErrorCB-Rückruf.
Die API zum Zugriff Medien Dateiformat-Information ist begrenzt, so dass nicht alle MediaFileData Eigenschaften werden unterstützt.
Bietet keine API Informationen zum Media-Dateien, so dass alle MediaFileData-Objekte mit Standardwerten zurück.
Die API zum Zugriff Medien Dateiformat-Information ist begrenzt, so dass nicht alle MediaFileData Eigenschaften werden unterstützt.
Die API zum Zugriff Medien Dateiformat-Information ist begrenzt, so dass nicht alle MediaFileData Eigenschaften werden unterstützt.
Kapselt Eigenschaften einer Mediendatei erfassen.
Name: der Name der Datei, ohne Pfadinformationen. (DOM-String und enthält)
FullPath: der vollständige Pfad der Datei, einschließlich des Namens. (DOM-String und enthält)
Typ: Mime-Typ der Datei (DOM-String und enthält)
LastModifiedDate: das Datum und die Uhrzeit wann die Datei zuletzt geändert wurde. (Datum)
Größe: die Größe der Datei in Byte. (Anzahl)
Kapselt Formatinformationen zu einer Mediendatei.
Codecs: das tatsächliche Format der Audio- und video-Inhalte. (DOM-String und enthält)
Bitrate: die durchschnittliche Bitrate des Inhalts. Der Wert ist NULL für Bilder. (Anzahl)
Höhe: die Höhe des Bildes oder Videos in Pixel. Der Wert ist NULL für audio-Clips. (Anzahl)
Breite: die Breite des Bildes oder Videos in Pixel. Der Wert ist NULL für audio-Clips. (Anzahl)
Dauer: die Länge des Video- oder Clips in Sekunden. Der Wert ist NULL für Bilder. (Anzahl)
Keine API bietet Formatierungsinformationen für Mediendateien, so dass das MediaFileData-Objekt durch MediaFile.getFormatData Features die folgenden Standardwerte zurückgegeben:
Codecs: nicht unterstützt, und gibtnull.
Bitrate: nicht unterstützt, und gibt den Wert NULL.
Höhe: nicht unterstützt, und gibt den Wert NULL.
Breite: nicht unterstützt, und gibt den Wert NULL.
Dauer: nicht unterstützt, und gibt den Wert NULL.
Unterstützt die folgenden MediaFileData Eigenschaften:
Codecs: nicht unterstützt, und gibtnull.
Bitrate: nicht unterstützt, und gibt den Wert NULL.
Höhe: unterstützt: nur Bild und Video-Dateien.
Breite: unterstützt: nur Bild und Video-Dateien.
Dauer: unterstützt: Audio- und video-Dateien nur
Unterstützt die folgenden MediaFileData Eigenschaften:
Codecs: nicht unterstützt, und gibtnull.
Bitrate: nicht unterstützt, und gibt den Wert NULL.
Höhe: unterstützt: nur Bild und Video-Dateien.
Breite: unterstützt: nur Bild und Video-Dateien.
Dauer: unterstützt: Audio- und video-Dateien nur.
Unterstützt die folgenden MediaFileData Eigenschaften:
Codecs: nicht unterstützt, und gibtnull.
Bitrate: iOS4 Geräten für nur Audio unterstützt. Gibt 0 (null) für Bilder und Videos.
Höhe: unterstützt: nur Bild und Video-Dateien.
Breite: unterstützt: nur Bild und Video-Dateien.
Dauer: unterstützt: Audio- und video-Dateien nur.