openEventsPlatformApp/plugins/cordova-plugin-camera/doc/de/index.md
plugins/cordova-plugin-camera/doc/de/index.mdRaw
1<!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18-->
19
20# cordova-plugin-camera
21
22Dieses Plugin definiert eine globale `navigator.camera`-Objekt, das eine API für Aufnahmen und für die Auswahl der Bilder aus dem System-Image-Library bietet.
23
24Obwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.
25
26 document.addEventListener("deviceready", onDeviceReady, false);
27 function onDeviceReady() {
28 console.log(navigator.camera);
29 }
30
31
32## Installation
33
34 cordova plugin add cordova-plugin-camera
35
36
37## navigator.camera.getPicture
38
39Nimmt ein Foto mit der Kamera, oder ein Foto aus dem Gerät Bildergalerie abgerufen. Das Bild wird an den Erfolg-Rückruf als base64-codierte `String` oder als URI für die Image-Datei übergeben. Die Methode selbst gibt ein `CameraPopoverHandle`-Objekt, das verwendet werden kann, um die Datei-Auswahl-Popover neu zu positionieren.
40
41 navigator.camera.getPicture( cameraSuccess, cameraError, cameraOptions );
42
43
44### Beschreibung
45
46Die `camera.getPicture`-Funktion öffnet das Gerät Standard-Kamera-Anwendung, die Benutzern ermöglicht, Bilder ausrichten. Dieses Verhalten tritt in der Standardeinstellung, wenn `Camera.sourceType` `Camera.PictureSourceType.CAMERA` entspricht. Sobald der Benutzer die Fotoschnäpper, die Kameraanwendung geschlossen wird und die Anwendung wird wiederhergestellt.
47
48Wenn `Camera.sourceType` `Camera.PictureSourceType.PHOTOLIBRARY` oder `Camera.PictureSourceType.SAVEDPHOTOALBUM` ist, dann wird ein Dialogfeld angezeigt, das Benutzern ermöglicht, ein vorhandenes Bild auszuwählen. Die `camera.getPicture`-Funktion gibt ein `CameraPopoverHandle`-Objekt, das verwendet werden kann, um die Bild-Auswahl-Dialog, z. B. beim ändert sich der Orientierung des Geräts neu positionieren.
49
50Der Rückgabewert wird an die `cameraSuccess`-Callback-Funktion in einem der folgenden Formate, je nach dem angegebenen `cameraOptions` gesendet:
51
52* A `String` mit dem base64-codierte Foto-Bild.
53
54* A `String` , die die Bild-Datei-Stelle auf lokalem Speicher (Standard).
55
56Sie können tun, was Sie wollen, mit dem codierten Bildes oder URI, zum Beispiel:
57
58* Rendern Sie das Bild in ein `<img>` Tag, wie im folgenden Beispiel
59
60* Die Daten lokal zu speichern ( `LocalStorage` , [Lawnchair][1], etc..)
61
62* Post die Daten an einen entfernten server
63
64 [1]: http://brianleroux.github.com/lawnchair/
65
66**Hinweis**: Fotoauflösung auf neueren Geräten ist ganz gut. Fotos aus dem Gerät Galerie ausgewählt sind nicht zu einer niedrigeren Qualität herunterskaliert, selbst wenn ein `Qualität`-Parameter angegeben wird. Um Speicherprobleme zu vermeiden, legen Sie `Camera.destinationType` auf `FILE_URI` statt `DATA_URL`.
67
68### Unterstützte Plattformen
69
70* Amazon Fire OS
71* Android
72* BlackBerry 10
73* Browser
74* Firefox OS
75* iOS
76* Tizen
77* Windows Phone 7 und 8
78* Windows 8
79
80### "Einstellungen" (iOS)
81
82* **CameraUsesGeolocation** (Boolean, Standardwert ist False). Zur Erfassung von JPEGs, auf true festgelegt, um Geolocation-Daten im EXIF-Header zu erhalten. Dies löst einen Antrag auf Geolocation-Berechtigungen, wenn auf True festgelegt.
83
84 <preference name="CameraUsesGeolocation" value="false" />
85
86
87### Amazon Fire OS Macken
88
89Amazon Fire OS verwendet Absichten zum Starten von der Kamera-Aktivität auf dem Gerät, um Bilder zu erfassen und auf Handys mit wenig Speicher, Cordova Tätigkeit getötet werden kann. In diesem Szenario kann das Bild nicht angezeigt, wenn die Aktivität von Cordova wiederhergestellt wird.
90
91### Android Eigenarten
92
93Android verwendet Absichten zum Starten von der Kamera-Aktivität auf dem Gerät, um Bilder zu erfassen und auf Handys mit wenig Speicher, Cordova Tätigkeit getötet werden kann. In diesem Szenario kann das Bild nicht angezeigt, wenn die Aktivität von Cordova wiederhergestellt wird.
94
95### Browser-Eigenheiten
96
97Fotos können nur als base64-codierte Bild zurückgeben werden.
98
99### Firefox OS Macken
100
101Kamera-Plugin ist derzeit implementiert mithilfe von [Web-Aktivitäten][2].
102
103 [2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
104
105### iOS Macken
106
107Einschließlich einer JavaScript-`alert()` entweder Rückruffunktionen kann Probleme verursachen. Wickeln Sie die Warnung innerhalb eine `setTimeout()` erlauben die iOS-Bild-Picker oder Popover vollständig zu schließen, bevor die Warnung angezeigt:
108
109 setTimeout(function() {
110 // do your thing here!
111 }, 0);
112
113
114### Windows Phone 7 Macken
115
116Die native Kameraanwendung aufrufen, während das Gerät via Zune angeschlossen ist funktioniert nicht und löst eine Fehler-Callback.
117
118### Tizen Macken
119
120Tizen unterstützt nur ein `DestinationType` von `Camera.DestinationType.FILE_URI` und ein `SourceType` von `Camera.PictureSourceType.PHOTOLIBRARY`.
121
122### Beispiel
123
124Nehmen Sie ein Foto und rufen Sie sie als base64-codierte Bild:
125
126 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
127 destinationType: Camera.DestinationType.DATA_URL
128 });
129
130 function onSuccess(imageData) {
131 var image = document.getElementById('myImage');
132 image.src = "data:image/jpeg;base64," + imageData;
133 }
134
135 function onFail(message) {
136 alert('Failed because: ' + message);
137 }
138
139
140Nehmen Sie ein Foto und rufen Sie das Bild-Datei-Speicherort:
141
142 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
143 destinationType: Camera.DestinationType.FILE_URI });
144
145 function onSuccess(imageURI) {
146 var image = document.getElementById('myImage');
147 image.src = imageURI;
148 }
149
150 function onFail(message) {
151 alert('Failed because: ' + message);
152 }
153
154
155## CameraOptions
156
157Optionale Parameter die Kameraeinstellungen anpassen.
158
159 { quality : 75,
160 destinationType : Camera.DestinationType.DATA_URL,
161 sourceType : Camera.PictureSourceType.CAMERA,
162 allowEdit : true,
163 encodingType: Camera.EncodingType.JPEG,
164 targetWidth: 100,
165 targetHeight: 100,
166 popoverOptions: CameraPopoverOptions,
167 saveToPhotoAlbum: false };
168
169
170### Optionen
171
172* **Qualität**: Qualität des gespeicherten Bildes, ausgedrückt als ein Bereich von 0-100, wo 100 in der Regel voller Auflösung ohne Verlust aus der Dateikomprimierung ist. Der Standardwert ist 50. *(Anzahl)* (Beachten Sie, dass Informationen über die Kamera Auflösung nicht verfügbar ist.)
173
174* **DestinationType**: Wählen Sie das Format des Rückgabewerts. Der Standardwert ist FILE_URI. Im Sinne `navigator.camera.DestinationType` *(Anzahl)*
175
176 Camera.DestinationType = {
177 DATA_URL : 0, // Return image as base64-encoded string
178 FILE_URI : 1, // Return image file URI
179 NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
180 };
181
182
183* **SourceType**: Legen Sie die Quelle des Bildes. Der Standardwert ist die Kamera. Im Sinne `navigator.camera.PictureSourceType` *(Anzahl)*
184
185 Camera.PictureSourceType = {
186 PHOTOLIBRARY : 0,
187 CAMERA : 1,
188 SAVEDPHOTOALBUM : 2
189 };
190
191
192* **AllowEdit**: einfache Bearbeitung des Bildes vor Auswahl zu ermöglichen. *(Boolesch)*
193
194* **EncodingType**: die zurückgegebene Image-Datei ist Codierung auswählen. Standardwert ist JPEG. Im Sinne `navigator.camera.EncodingType` *(Anzahl)*
195
196 Camera.EncodingType = {
197 JPEG : 0, // Return JPEG encoded image
198 PNG : 1 // Return PNG encoded image
199 };
200
201
202* **TargetWidth**: Breite in Pixel zum Bild skalieren. Muss mit **TargetHeight**verwendet werden. Seitenverhältnis bleibt konstant. *(Anzahl)*
203
204* **TargetHeight**: Höhe in Pixel zum Bild skalieren. Muss mit **TargetWidth**verwendet werden. Seitenverhältnis bleibt konstant. *(Anzahl)*
205
206* **MediaType**: Legen Sie den Typ der Medien zur Auswahl. Funktioniert nur, wenn `PictureSourceType` ist `PHOTOLIBRARY` oder `SAVEDPHOTOALBUM` . Im Sinne `nagivator.camera.MediaType` *(Anzahl)*
207
208 Camera.MediaType = {
209 PICTURE: 0, // allow selection of still pictures only. STANDARD. Will return format specified via DestinationType
210 VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
211 ALLMEDIA : 2 // allow selection from all media types
212 };
213
214
215* **CorrectOrientation**: Drehen Sie das Bild um die Ausrichtung des Geräts während der Aufnahme zu korrigieren. *(Boolesch)*
216
217* **SaveToPhotoAlbum**: das Bild auf das Fotoalbum auf dem Gerät zu speichern, nach Einnahme. *(Boolesch)*
218
219* **PopoverOptions**: iOS-nur Optionen, die Popover Lage in iPad angeben. In definierten`CameraPopoverOptions`.
220
221* **CameraDirection**: Wählen Sie die Kamera (vorn oder hinten-gerichtete) verwenden. Der Standardwert ist zurück. Im Sinne `navigator.camera.Direction` *(Anzahl)*
222
223 Camera.Direction = {
224 BACK : 0, // Use the back-facing camera
225 FRONT : 1 // Use the front-facing camera
226 };
227
228
229### Amazon Fire OS Macken
230
231* `cameraDirection`Ergebnisse in einem hinten gerichteter Foto Wert.
232
233* Ignoriert die `allowEdit` Parameter.
234
235* `Camera.PictureSourceType.PHOTOLIBRARY`und `Camera.PictureSourceType.SAVEDPHOTOALBUM` beide das gleiche Fotoalbum anzuzeigen.
236
237### Android Eigenarten
238
239* `cameraDirection`Ergebnisse in einem hinten gerichteter Foto Wert.
240
241* Ignoriert die `allowEdit` Parameter.
242
243* `Camera.PictureSourceType.PHOTOLIBRARY`und `Camera.PictureSourceType.SAVEDPHOTOALBUM` beide das gleiche Fotoalbum anzuzeigen.
244
245### BlackBerry 10 Macken
246
247* Ignoriert die `quality` Parameter.
248
249* Ignoriert die `allowEdit` Parameter.
250
251* `Camera.MediaType`wird nicht unterstützt.
252
253* Ignoriert die `correctOrientation` Parameter.
254
255* Ignoriert die `cameraDirection` Parameter.
256
257### Firefox OS Macken
258
259* Ignoriert die `quality` Parameter.
260
261* `Camera.DestinationType`wird ignoriert, und gleich `1` (Bilddatei-URI)
262
263* Ignoriert die `allowEdit` Parameter.
264
265* Ignoriert die `PictureSourceType` Parameter (Benutzer wählt es in einem Dialogfenster)
266
267* Ignoriert die`encodingType`
268
269* Ignoriert die `targetWidth` und`targetHeight`
270
271* `Camera.MediaType`wird nicht unterstützt.
272
273* Ignoriert die `correctOrientation` Parameter.
274
275* Ignoriert die `cameraDirection` Parameter.
276
277### iOS Macken
278
279* Legen Sie `quality` unter 50 Speicherfehler auf einigen Geräten zu vermeiden.
280
281* Bei der Verwendung `destinationType.FILE_URI` , Fotos werden im temporären Verzeichnis der Anwendung gespeichert. Den Inhalt des temporären Verzeichnis der Anwendung wird gelöscht, wenn die Anwendung beendet.
282
283### Tizen Macken
284
285* nicht unterstützte Optionen
286
287* gibt immer einen Datei-URI
288
289### Windows Phone 7 und 8 Eigenarten
290
291* Ignoriert die `allowEdit` Parameter.
292
293* Ignoriert die `correctOrientation` Parameter.
294
295* Ignoriert die `cameraDirection` Parameter.
296
297* Ignoriert die `saveToPhotoAlbum` Parameter. WICHTIG: Alle Aufnahmen die wp7/8 Cordova-Kamera-API werden immer in Kamerarolle des Telefons kopiert. Abhängig von den Einstellungen des Benutzers könnte dies auch bedeuten, dass das Bild in ihre OneDrive automatisch hochgeladen ist. Dies könnte möglicherweise bedeuten, dass das Bild für ein breiteres Publikum als Ihre Anwendung vorgesehen ist. Wenn diese einen Blocker für Ihre Anwendung, Sie müssen die CameraCaptureTask zu implementieren, wie im Msdn dokumentiert: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> Sie können kommentieren oder Up-Abstimmung das Beiträge zu diesem Thema im [Bugtracker][3]
298
299* Ignoriert die `mediaType` -Eigenschaft des `cameraOptions` wie das Windows Phone SDK keine Möglichkeit, Fotothek Videos wählen.
300
301 [3]: https://issues.apache.org/jira/browse/CB-2083
302
303## CameraError
304
305onError-Callback-Funktion, die eine Fehlermeldung bereitstellt.
306
307 function(message) {
308 // Show a helpful message
309 }
310
311
312### Parameter
313
314* **Meldung**: die Nachricht wird durch das Gerät systemeigenen Code bereitgestellt. *(String)*
315
316## cameraSuccess
317
318onSuccess Callback-Funktion, die die Bilddaten bereitstellt.
319
320 function(imageData) {
321 // Do something with the image
322 }
323
324
325### Parameter
326
327* **CMYK**: Base64-Codierung der Bilddaten, *oder* die Image-Datei-URI, je nach `cameraOptions` in Kraft. *(String)*
328
329### Beispiel
330
331 // Show image
332 //
333 function cameraCallback(imageData) {
334 var image = document.getElementById('myImage');
335 image.src = "data:image/jpeg;base64," + imageData;
336 }
337
338
339## CameraPopoverHandle
340
341Ein Handle für das Dialogfeld "Popover" erstellt von `navigator.camera.getPicture`.
342
343### Methoden
344
345* **SetPosition**: Legen Sie die Position der Popover.
346
347### Unterstützte Plattformen
348
349* iOS
350
351### setPosition
352
353Legen Sie die Position von der Popover.
354
355**Parameter**:
356
357* `cameraPopoverOptions`: die `CameraPopoverOptions` angeben, dass die neue Position
358
359### Beispiel
360
361 var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
362 { destinationType: Camera.DestinationType.FILE_URI,
363 sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
364 popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
365 });
366
367 // Reposition the popover if the orientation changes.
368 window.onorientationchange = function() {
369 var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
370 cameraPopoverHandle.setPosition(cameraPopoverOptions);
371 }
372
373
374## CameraPopoverOptions
375
376nur iOS-Parametern, die Anker-Element Lage und Pfeil Richtung der Popover angeben, bei der Auswahl von Bildern aus einem iPad Bibliothek oder Album.
377
378 { x : 0,
379 y : 32,
380 width : 320,
381 height : 480,
382 arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
383 };
384
385
386### CameraPopoverOptions
387
388* **X**: x Pixelkoordinate des Bildschirmelement auf dem der Popover zu verankern. *(Anzahl)*
389
390* **y**: y Pixelkoordinate des Bildschirmelement auf dem der Popover zu verankern. *(Anzahl)*
391
392* **width**: Breite in Pixeln, das Bildschirmelement auf dem der Popover zu verankern. *(Anzahl)*
393
394* **height**: Höhe in Pixeln, das Bildschirmelement auf dem der Popover zu verankern. *(Anzahl)*
395
396* **arrowDir**: Richtung der Pfeil auf der Popover zeigen sollte. Im Sinne `Camera.PopoverArrowDirection` *(Anzahl)*
397
398 Camera.PopoverArrowDirection = {
399 ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
400 ARROW_DOWN : 2,
401 ARROW_LEFT : 4,
402 ARROW_RIGHT : 8,
403 ARROW_ANY : 15
404 };
405
406
407Beachten Sie, dass die Größe der Popover ändern kann, um die Richtung des Pfeils und Ausrichtung des Bildschirms anzupassen. Achten Sie darauf, um Orientierung zu berücksichtigen, wenn Sie den Anker-Element-Speicherort angeben.
408
409## navigator.camera.cleanup
410
411Entfernt Mittelstufe Fotos von der Kamera aus der vorübergehenden Verwahrung genommen.
412
413 navigator.camera.cleanup( cameraSuccess, cameraError );
414
415
416### Beschreibung
417
418Fortgeschrittene Image-Dateien, die in vorübergehender Verwahrung gehalten werden, nach dem Aufruf von `camera.getPicture` entfernt. Gilt nur wenn der Wert von `Camera.sourceType` gleich `Camera.PictureSourceType.CAMERA` und `Camera.destinationType` gleich `Camera.DestinationType.FILE_URI`.
419
420### Unterstützte Plattformen
421
422* iOS
423
424### Beispiel
425
426 navigator.camera.cleanup(onSuccess, onFail);
427
428 function onSuccess() {
429 console.log("Camera cleanup success.")
430 }
431
432 function onFail(message) {
433 alert('Failed because: ' + message);
434 }