CameraRoll  - AS3

Uygulamaya film rulosu erişiminin verilip verilmediğini belirler.

İlgili API Öğeleri

CameraRoll.addBitmapData() yönteminin desteklenip desteklenmediği. Şu anda, bu özellik yalnızca mobil aygıtlardaki AIR uygulamalarında desteklenir.

CameraRoll.browseForImage() yönteminin desteklenip desteklenmediğini bildirir. Şu anda, bu özellik yalnızca mobil aygıtlardaki AIR uygulamalarında desteklenir.

Bir CameraRoll nesnesi oluşturur.

ActionScript tarafından desteklenen yalnızca tek bir medya kitaplığı vardır. Tüm CameraRoll nesneleri aynı görüntü havuzuna kaydeder.

Aygıtın film rulosuna bir görüntü ekler.

Çalışma zamanında uygulamanızın CameraRoll.addBitmapData() yöntemini destekleyip desteklemediğini kontrol etmek için, CameraRoll.supportsAddBitmapData özelliğini kontrol edin.

Parametreler

Kullanıcının aygıtın film rulosunda varolan bir görüntüyü seçmesine olanak vermek için bir görüntü göz atma iletişim kutusu açar.

Kullanıcı bir görüntü seçtiğinde, bu CameraRoll örneği bir MediaEvent nesnesi içeren bir select olayı gönderir. Görüntüyü yüklemek için MediaEvent nesnesinin data özelliğini kullanın. data özelliği, Loader sınıfının loadFilePromise() yöntemini kullanarak yükleyebileceğiniz bir MediaPromise nesnesidir. MediaPromise nesnesinin bazı platformlarda (Blackberry Tablet OS) geçerli bir dosya nesnesi içerdiğini ancak diğerlerinde (iOS ve Android) bu nesnenin bulunmadığını unutmayın. loadFilePromise() yöntemini kullandığınızda görüntü tüm platformlara düzgün bir şekilde yüklenir. Medya nesnesinden ham verilere erişmek için medya izninin sağladığı veri kaynağını açabilir ve IDataInput arabirimindeki yöntemleri kullanarak verileri okuyabilirsiniz.

Çalışma zamanında uygulamanızın CameraRoll.browseForImage() yöntemini destekleyip desteklemediğini kontrol etmek için CameraRoll.supportsBrowseForImage özelliğini kontrol edin.

iOS üzerinde (ve yalnızca iPad üzerinde) görüntü tarayıcısı iletişim kutusu için belirli bir boyut isteyebilirsiniz. Ayrıca görüntü tarayıcısı iletişim kutusunun kaplamasını istemediğiniz ekran alanını belirtebilirsiniz. Görüntü tarayıcısı, iPad üzerinde ekranın tamamını kaplamadığı için bu istek yalnızca bu aygıt üzerinde çalışır.

Görüntü tarayıcısı için boyut ve yerleştirme seçenekleri istemek üzere (iPad için) browseForImage() öğesine bir CameraRollBrowseOptions nesnesi iletin. Parametreler olmadan bu yöntem, iletişim kutusunun boyutları için sistem varsayılanlarını kullanarak iletişim kutusunu görüntünün sol üst köşesine yerleştirir.

Parametreler

Daha fazla bilgi

İlgili API Öğeleri

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

Sistem medya kitaplığı veya "film rulosuna" erişim izni ister.

Bir kullanıcı herhangi bir görüntü seçmeden görüntüye göz atma işlemini iptal ederse gönderilir.

Bu olay şu özelliklere sahiptir:

Bir addBitmapData() işleminin başarıyla tamamlandığını söyler.

Bu olay şu özelliklere sahiptir:

Bir hata oluştuğunda error olayı gönderilir.

Hata kaynakları arasında şunlar bulunur:

• Bir görüntü tarayıcı açılamaz.
• Bir görüntü tarayıcı zaten kullanımdadır.
• AIR uygulaması, arka planda çalışırken bir görüntüye göz atmaya çalışır.
• Bir görüntü medya kitaplığına eklenemez.
• Aygıtta desteklenmeyen bir yöntem çağrılır.
• AIR uygulaması Internet bağlantısı olmadan uzak bir görüntüyü yüklemeye çalışır.

Bu olay şu özelliklere sahiptir:

Uygulama, film rulosuna erişim izni istediğinde gönderilir. İznin verildiğini veya reddedildiğini belirlemek için status özelliğinin değerini kontrol edin

İlgili API Öğeleri

Bir kullanıcı aygıt medya kitaplığından görüntü seçtiğinde gönderilir.

Bu olay için gönderilen MediaEvent nesnesi, seçilen medyaya erişim sağlar.

Bir MediaEvent olay nesnesinin type özelliğinin değerini tanımlar. Bu olay şu özelliklere sahiptir: