Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: Sunucudan Veri Alınıyor...
Sunucudan Veri Alınıyor...
flash.media 

CameraUI  - AS3

Paketflash.media
Sınıfpublic class CameraUI
Miras AlmaCameraUI Inheritance EventDispatcher Inheritance Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

CameraUI sınıfı, bir aygıttaki varsayılan kamera uygulamasını kullanarak hareketsiz görüntü veya video yakalamanıza olanak verir.

launch() yöntemi, aygıtın varsayılan kamera uygulamasını açmasını ister. Yakalanan görüntü veya video, complete olayı için gönderilen MediaEvent nesnesinde kullanılabilir olur. Varsayılan kamera uygulaması görüntüyü veya videoyu çeşitli biçimlerde kaydedebileceğinden, döndürülen medya nesnesinin AIR çalışma zamanı tarafından yüklenip görüntülenebileceğine dair herhangi bir garanti yoktur.

Bazı platformlarda kamera tarafından döndürülen media nesnesine dosya bazlı medya izni olarak erişilebilir. Diğerlerinde medya izni dosya bazlı değildir ve MediaPromise nesnesinin file ve relativePath özellikleri null değerine sahiptir. Bu özellikleri birden fazla platformda kullanılan kodda kullanmayın.

Android üzerinde, harici saklama kartı kullanılabilir durumda değilse (kullanıcının kartı USB yığın saklama aygıtı olarak taktığında olduğu gibi) varsayılan kamera uygulaması açılmaz. Ayrıca kamerayı başlatan AIR uygulaması odağı kaybeder. Aygıtın kullandığı kaynaklar azalırsa AIR uygulaması, medya yakalama işlemi tamamlanmadan önce işletim sistemi tarafından sonlandırılabilir.

Bazı platformlarda media nesnesi otomatik olarak aygıtın medya kütüphanesinde saklanır. Görüntülerin ve videoların otomatik olarak varsayılan kamera uygulaması tarafından depolanmadığı platformlarda media nesnesini depolamak için CameraRoll addBitmapData() işlevini kullanabilirsiniz.

AIR profil desteği: Bu özellik mobil aygıtlarda desteklenir ancak masaüstü işletim sistemlerinde ve AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında CameraUI.isSupported özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.

Örnekleri görüntüle

Daha fazla bilgi



Genel Özellikler
 ÖzellikTanımlayan:
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
      isSupported : Boolean
[statik] [salt okunur] CameraUI sınıfının geçerli aygıtta desteklenip desteklenmediğini bildirir.
CameraUI
      permissionStatus : String
[statik] [salt okunur] Uygulamaya kamera kullanımı izninin verilip verilmediğini belirler.
CameraUI
Genel Yöntemler
 YöntemTanımlayan:
  
    CameraUI()
Bir CameraUI nesnesi oluşturur.
CameraUI
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.
EventDispatcher
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
 Inherited
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.
EventDispatcher
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
  
    launch(requestedMediaType:String):void
Aygıttaki varsayılan kamera uygulamasını başlatır.
CameraUI
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher nesnesinden bir dinleyiciyi kaldırır.
EventDispatcher
  
Kamera Kullanıcı Arabirimine erişim izni ister.
CameraUI
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
 Inherited
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.
EventDispatcher
Olaylar
 Olay Özet Tanımlayan:
 Inherited[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.EventDispatcher
  
    cancel
Kullanıcı resmi veya videoyu kaydetmeden Kamera UI'sini kapattığında cancel olayı gönderilir.CameraUI
  
    complete
Kullanıcı, Kamera UI'sinde hareketsiz bir resim veya video yakaladığında complete olayı gönderilir.CameraUI
 Inherited[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.EventDispatcher
  
    error
Varsayılan kamera açılamadığında error olayı gönderilir.CameraUI
  Uygulama, kamera kullanıcı arabirimine erişim izni istediğinde gönderilir.CameraUI
Özellik Ayrıntısı
    

isSupported

özellik
isSupported:Boolean  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

CameraUI sınıfının geçerli aygıtta desteklenip desteklenmediğini bildirir. Şu anda, bu özellik yalnızca Android üzerindeki AIR uygulamalarında desteklenir.



Uygulama
    public static function get isSupported():Boolean
    

permissionStatus

özellik 
permissionStatus:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 24.0

Uygulamaya kamera kullanımı izninin verilip verilmediğini belirler.



Uygulama
    public static function get permissionStatus():String

İlgili API Öğeleri

Yapıcı Ayrıntı
    

CameraUI

()Yapıcı
public function CameraUI()

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Bir CameraUI nesnesi oluşturur.

Yöntem Ayrıntısı

    launch

()yöntem
public function launch(requestedMediaType:String):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Aygıttaki varsayılan kamera uygulamasını başlatır.

Bu sınıfla hareketsiz görüntü veya video yakalayabilirsiniz. Video yakalama işlemi sırasında aygıttaki "Quality Low" (Düşük Kalite) kamera profili kullanılır.

launch() yöntemi çağrıldığında, aygıttaki varsayılan kamera uygulaması başlatılır. AIR uygulaması odağı kaybeder ve kullanıcının hareketsiz bir görüntü yakalamasını veya video yakalama işlemini bitirmesini bekler. İstenen medya kullanıcı tarafından yakalandıktan sonra, AIR uygulaması odağı yeniden kazanır ve bu CameraUI nesnesi bir complete olayı gönderir. Kullanıcı işlemi iptal ederse, bu CameraUI nesnesi bunun yerine bir cancel olayı gönderir.

Not: Arka planda kullanıcının bir görüntü veya video yakalamasını beklerken AIR uygulamasının Android işletim sistemi tarafından kapatılması olasıdır. Böyle bir durumda, kullanıcının uygulamayı yeniden başlatması gerekir. AIR uygulaması, önceki görüntü yakalama işlemi için bir medya olayı göndermez.

complete olayı için gönderilen MediaEvent nesnesinin data özelliğini kullanarak yakalanan medya dosyasına erişebilirsiniz. Bu özellik, Loader sınıfının loadFilePromise() yöntemini kullanarak uygulamanıza yükleyebileceğiniz MediaPromise sınıfının bir örneğidir. Aygıt kamerasının yakalanan medyayı çeşitli biçimlerde kaydedebileceğini aklınızda bulundurun. Özellikle video bu bakımdan biraz sorunludur. Yakalanan medyanın AIR'de görüntülenmesi mümkün olmayabilir.

Parametreler

requestedMediaType:String — Yakalanacak medya nesnesinin türü. MediaType sınıfında bu parametre için geçerli değerler tanımlanmıştır:
  • MediaType.IMAGE
  • MediaType.VIDEO


Olaylar
complete:MediaEvent — Bir medya nesnesi yakalandığında gönderilir.
 
cancel:Event — Kullanıcı, bir medya nesnesi yakalamadan yerel kameradan çıktığında gönderilir.
 
error:ErrorEvent — Varsayılan kamera uygulaması zaten kullanımdaysa gönderilir.
 
error:ErrorEvent — Bu işlevi çağırdığında AIR uygulaması arka planda çalışıyorsa gönderilir.

Atar
PermissionError — Uygulama kamerayı kullanma iznine sahip değildir.

İlgili API Öğeleri

    requestPermission

()yöntem 
public function requestPermission():void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 24.0

Kamera Kullanıcı Arabirimine erişim izni ister.


Olaylar
PermissionStatus:PermissionEvent — İstenilen izin kullanıcı tarafından verildiğinde/reddedildiğinde gönderilir.
Olay Ayrıntısı
    

cancel

Olay
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.CANCEL

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Kullanıcı resmi veya videoyu kaydetmeden Kamera UI'sini kapattığında cancel olayı gönderilir.

Event.CANCEL sabiti, cancel olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetÜzerindeki işlem iptal edilen nesnenin başvurusu.
    

complete

Olay  
Olay Nesne Türü: flash.events.MediaEvent
özellik MediaEvent.type = flash.events.MediaEvent.COMPLETE

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Kullanıcı, Kamera UI'sinde hareketsiz bir resim veya video yakaladığında complete olayı gönderilir.

complete MediaEvent öğesi için bir sabit.

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

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
dataKullanılabilir medya örneğinin MediaPromise nesnesi.
    

error

Olay  
Olay Nesne Türü: flash.events.ErrorEvent
özellik ErrorEvent.type = flash.events.ErrorEvent.ERROR

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Varsayılan kamera açılamadığında error olayı gönderilir.

Bir error olay nesnesinin type özelliğinin değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetAğ işlemi arızası yaşayan nesne.
textHata mesajı olarak gösterilecek metin.
    

permissionStatus

Olay  
Olay Nesne Türü: flash.events.PermissionEvent
özellik PermissionEvent.type = flash.events.PermissionEvent.PERMISSION_STATUS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 24.0

Uygulama, kamera kullanıcı arabirimine erişim izni istediğinde gönderilir. İznin verildiğini veya reddedildiğini kontrol etmek için status özelliğinin değerini kontrol edin

İlgili API Öğeleri

CameraUIExample.Still.1.as

Aşağıdaki örnekte, aygıttaki varsayılan kamera uygulamasını başlatmak için CameraUI sınıfı kullanılmaktadır. Kullanıcı bir resim çektiğinde, görüntü görüntüleme listesine yerleştirilmektedir.
package  {
 import flash.desktop.NativeApplication;
 import flash.display.Loader;
 import flash.display.MovieClip;
 import flash.display.StageAlign;
 import flash.display.StageScaleMode;
 import flash.events.ErrorEvent;
 import flash.events.Event;
 import flash.events.IOErrorEvent;
 import flash.events.MediaEvent;
 import flash.media.CameraUI;
 import flash.media.MediaPromise;
 import flash.media.MediaType;
 
     public class CameraUIStillImage extends MovieClip{

          private var deviceCameraApp:CameraUI = new CameraUI();
          private var imageLoader:Loader; 
    
          public function CameraUIStillImage() {
               this.stage.align = StageAlign.TOP_LEFT;
               this.stage.scaleMode = StageScaleMode.NO_SCALE;
       
               if( CameraUI.isSupported )
               {
                trace( "Initializing camera..." );
    
                deviceCameraApp.addEventListener( MediaEvent.COMPLETE, imageCaptured );
                deviceCameraApp.addEventListener( Event.CANCEL, captureCanceled );
                deviceCameraApp.addEventListener( ErrorEvent.ERROR, cameraError );
                deviceCameraApp.launch( MediaType.IMAGE );
               }
               else
               {
                trace( "Camera interface is not supported.");
               }
          }
    
          private function imageCaptured( event:MediaEvent ):void
          {
               trace( "Media captured..." );
       
               var imagePromise:MediaPromise = event.data;
       
               if( imagePromise.isAsync )
               {
                trace( "Asynchronous media promise." );
                imageLoader = new Loader();
                imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, asyncImageLoaded );
                imageLoader.addEventListener( IOErrorEvent.IO_ERROR, cameraError );
                
                imageLoader.loadFilePromise( imagePromise );
               }
               else
               {
                trace( "Synchronous media promise." );
                imageLoader.loadFilePromise( imagePromise );
                showMedia( imageLoader );
               }
          }
    
          private function captureCanceled( event:Event ):void
          {
               trace( "Media capture canceled." );
               NativeApplication.nativeApplication.exit();
          }
    
          private function asyncImageLoaded( event:Event ):void
          {
               trace( "Media loaded in memory." );
               showMedia( imageLoader );    
          }
    
          private function showMedia( loader:Loader ):void
          {
               this.addChild( loader );
          }
      
          private function cameraError( error:ErrorEvent ):void
          {
               trace( "Error:" + error.text );
               NativeApplication.nativeApplication.exit();
          }
     }
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.