CameraRoll  - AS3

Bestimmen Sie, ob der Anwendung die Berechtigung zum Zugriff auf die Camera Roll erteilt wurde.

Verwandte API-Elemente

Ob die CameraRoll.addBitmapData()-Methode unterstützt wird. Zurzeit wird diese Funktion nur in AIR-Anwendungen auf mobilen Geräten unterstützt.

Gibt an, ob die CameraRoll.browseForImage()-Methode unterstützt wird. Zurzeit wird diese Funktion nur in AIR-Anwendungen auf mobilen Geräten unterstützt.

Erstellt ein CameraRoll-Objekt.

Von ActionScript wird nur eine Medienbibliothek unterstützt. Alle CameraRoll-Objekte speichern in demselben Bildrepository.

Fügt ein Bild der Camera Roll des Geräts hinzu.

Um zur Laufzeit festzustellen, ob Ihre Anwendung die CameraRoll.addBitmapData()-Methode unterstützt, überprüfen Sie die CameraRoll.supportsAddBitmapData-Eigenschaft.

Parameter

Öffnet ein Dialogfeld zur Bildauswahl, in dem der Benutzer ein vorhandenes Bild aus der Camera Roll des Geräts auswählen kann.

Wenn der Benutzer ein Bild auswählt, setzt diese CameraRoll-Instanz ein select-Ereignis ab, das ein MediaEvent-Objekt enthält. Mit der data-Eigenschaft des MediaEvent-Objekts können Sie das Bild laden. Die data-Eigenschaft ist ein MediaPromise-Objekt, das Sie mit der loadFilePromise()-Methode der Loader-Klasse laden können. Beachten Sie, dass das MediaPromise-Objekt auf einigen Plattformen (Blackberry Tablet OS) ein gültiges Dateiobjekt enthält, auf anderen (iOS und Android) dagegen nicht. Wenn Sie die loadFilePromise()-Methode verwenden, wird das Bild auf allen Plattformen richtig geladen. Um auf die Grunddaten des Medienobjekts zuzugreifen, können Sie die von der Medienzusage bereitgestellte Datenquelle öffnen und die Daten mit den Methoden der IDataInput-Schnittstelle lesen.

Um zur Laufzeit festzustellen, ob Ihre Anwendung die CameraRoll.browseForImage()-Methode unterstützt, überprüfen Sie die CameraRoll.supportsBrowseForImage-Eigenschaft.

Unter iOS (nur auf dem iPad) können Sie eine bestimmte Größe für das Dialogfeld zur Bildauswahl anfordern. Sie können auch einen Bildschirmbereich angeben, der nicht vom Dialogfeld für die Bildauswahl verdeckt werden soll. Diese Anforderung funktioniert nur auf dem iPad, da das Dialogfeld für die Bildauswahl auf diesem Gerät nicht den gesamten Bildschirm ausfüllt.

Um Größen- und Platzierungsoptionen für das Dialogfeld für die Bildauswahl anzufordern (auf dem iPad), übergeben Sie ein CameraRollBrowseOptions-Objekt an browseForImage(). Ohne Parameter positioniert diese Methode das Dialogfeld in der oberen linken Ecke des Bildschirms und verwendet die Standardeinstellungen des Systems für die Größe des Dialogfelds.

Parameter

Weitere Informationen

Verwandte API-Elemente

package flash.media.examples
{
        import flash.media.CameraRoll;
        import flash.media.MediaPromise;
        import flash.media.MediaType;
        import flash.events.MediaEvent;
        import flash.events.Event;
        import flash.display.Loader;
        import flash.display.Sprite;
        import flash.events.IOErrorEvent;
        import flash.display.StageAlign;
        import flash.display.StageScaleMode;
        
        public class CameraRollTest extends Sprite{
            private var mediaSource:CameraRoll = new CameraRoll();
            
            public function CameraRollTest() {
                this.stage.align = StageAlign.TOP_LEFT;
                this.stage.scaleMode = StageScaleMode.NO_SCALE;
                
                if( CameraRoll.supportsBrowseForImage )
                {
                    log( "Browsing for image..." );
                    mediaSource.addEventListener( MediaEvent.SELECT, imageSelected );
                    mediaSource.addEventListener( Event.CANCEL, browseCanceled );
                    
                    mediaSource.browseForImage();
                }
                else
                {
                    log( "Browsing in camera roll is not supported.");
                }
            }
            
            private var imageLoader:Loader; 
            private function imageSelected( event:MediaEvent ):void
            {
                log( "Image selected..." );
                
                var imagePromise:MediaPromise = event.data;
                
                imageLoader = new Loader();
                if( imagePromise.isAsync )
                {
                    log( "Asynchronous media promise." );
                    imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, imageLoaded );
                    imageLoader.contentLoaderInfo.addEventListener( IOErrorEvent.IO_ERROR, imageLoadFailed );
                    imageLoader.loadFilePromise( imagePromise );
                }
                else
                {
                    log( "Synchronous media promise." );
                    imageLoader.loadFilePromise( imagePromise );
                    this.addChild( imageLoader );
                }
            }
            
            private function browseCanceled( event:Event ):void
            {
                log( "Image browse canceled." );
            }
            
            private function imageLoaded( event:Event ):void
            {
                log( "Image loaded asynchronously." );
                this.addChild( imageLoader );
            }
            
            private function imageLoadFailed( event:Event ):void
            {
                log( "Image load failed." );
            }
            
            private function log( text:String ):void
            {
                trace( text );
            }
            
        }
        
    }

Fordert die Berechtigung zum Zugriff auf die Medienbibliothek oder „Camera Roll“ des Systems an.

Wird abgesetzt, wenn ein Benutzer einen Bildauswahlvorgang abbricht, ohne ein Bild auszuwählen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Zeigt an, dass ein addBitmapData()-Vorgang erfolgreich abgeschlossen wurde.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Das error-Ereignis wird abgesetzt, wenn ein Fehler auftritt.

Mögliche Fehlerquellen:

• Es kann kein Bildauswahldialog geöffnet werden.
• Es wird bereits ein Bildauswahldialogfeld verwendet.
• Die AIR-Anwendung versucht, nach einem Bild zu suchen, während sie sich im Hintergrund befindet.
• Ein Bild lässt sich nicht der Medienbibliothek hinzufügen.
• Es wird eine Methode aufgerufen, die vom Gerät nicht unterstützt wird.
• Die AIR-Anwendung versucht, ein Fernbild ohne Internetverbindung zu laden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn die Anwendung die Berechtigung zum Zugriff auf die Camera Roll anfordert. Überprüfen Sie den Wert der Eigenschaft Status, um festzustellen, ob die Berechtigung gewährt oder verweigert wurde.

Verwandte API-Elemente

Wird abgesetzt, wenn ein Benutzer ein Bild aus der Medienbibliothek des Geräts auswählt.

Das MediaEvent-Objekt, das für dieses Ereignis abgesetzt wird, ermöglicht den Zugriff auf das ausgewählten Medium.

Definiert den Wert der type-Eigenschaft eines MediaEvent-Ereignisobjekts. Dieses Ereignis verfügt über die folgenden Eigenschaften: