CameraRoll  - AS3

Avgör om programmet har beviljats behörighet att få tillgång till kamerabilder.

Relaterade API-element

Om metoden CameraRoll.addBitmapData() stöds. Funktionen stöds för tillfället bara i AIR-program på mobilenheter.

Rapporterar om metoden CameraRoll.browseForImage() stöds. Funktionen stöds för tillfället bara i AIR-program på mobilenheter.

Skapar ett CameraRoll-objekt.

Det finns bara ett mediebibliotek som stöds av ActionScript. Alla CameraRoll-objekt sparar data i samma bildarkiv.

Lägger till en bild i enhetens filmrulle.

Om du vid körning vill kontrollera om programmet har stöd för metoden CameraRoll.addBitmapData() kontrollerar du egenskapen CameraRoll.supportsAddBitmapData.

Parametrar

Öppnar en dialog för bildbläddring så att användaren kan välja en befintlig bild från enhetens filmrulle.

När användaren väljer en bild skickar den här CameraRoll-instansen en select-händelse som innehåller ett MediaEvent-objekt. Använd egenskapen data i MediaEvent-objektet för att läsa in bilden. Egenskapen data är ett MediaPromise-objekt som du kan läsa in med metoden loadFilePromise() i klassen Loader. Observera att MediaPromise-objektet innehåller ett giltigt filobjekt på vissa plattformar (Blackberry Tablet OS), men inte andra (iOS och Android). När du använder metoden loadFilePromise() läses egenskapen in som den ska på alla plattformar. För att komma åt raw-data från medieobjektet, ska du öppna datakällan som tillhandahålls av medielöftet och läsa data med hjälp av metoderna från IDataInput-gränssnittet.

Om du vid körning vill kontrollera om programmet har stöd för metoden CameraRoll.browseForImage() kontrollerar du egenskapen CameraRoll.supportsBrowseForImage.

På iOS (och endast på iPad) kan du begära en specifik storlek för bildläsarens dialogruta. Du kan även ange ett område på skärmen som du inte vill att bildläsarens dialogruta ska täcka. Denna begäran fungerar endast på iPad eftersom bildläsaren på den enheten inte upptar hela skärmen.

Om du vill begära storleks- och ersättningsalternativ för bildläsaren (för iPad), ska du skicka ett CameraRollBrowseOptions-objekt till browseForImage(). Om det inte finns några parametrar kommer den här metoden att placera dialogrutan i bildskärmens övre vänstra hörn med hjälp av systemstandardvärden för dialogrutans mått.

Parametrar

Lär dig mer

Relaterade API-element

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 );
            }
            
        }
        
    }

Begär tillgång till systemets mediebibliotek eller kamerabilder.

Skickas när en användare avbryter bläddrande efter bilder utan att välja någon bild.

Den här händelsen har följande egenskaper:

Signalerar att en addBitmapData()-åtgärd har slutförts utan fel.

Den här händelsen har följande egenskaper:

error-händelsen skickas när ett fel inträffar.

Felkällor omfattar bland annat:

• Det går inte att öppna någon bildläsare.
• En bildläsare används redan.
• AIR-programmet försöker bläddra efter en bild trots att det ligger i bakgrunden.
• Det går inte att lägga till en bild i mediebiblioteket.
• En metod som inte stöds på enheten anropades.
• AIR-programmet försöker läsa in en extern bild utan en internetanslutning.

Den här händelsen har följande egenskaper:

Skickas när programmet begär åtkomst till kamerabilder. Kontrollera värdet för egenskapen status för att avgöra om behörighet beviljades eller nekades

Relaterade API-element

Skickar när en användare väljer en bild från enhetens mediebibliotek.

Det MediaEvent-objekt som skickas för den här händelsen ger tillgång till det valda mediet.

Definierar värdet på type-egenskapen i ett MediaEvent-händelseobjekt. Den här händelsen har följande egenskaper: