Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
 |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: 서버에서 데이터를 검색하는 중...
서버에서 데이터를 검색하는 중...
flash.media 

CameraRoll  - AS3

패키지flash.media
클래스public class CameraRoll
상속CameraRoll Inheritance EventDispatcher Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: AIR 2

CameraRoll 클래스를 사용하여 시스템 미디어 라이브러리 또는 "카메라 롤"에 있는 이미지 데이터에 액세스할 수 있습니다.

AIR 프로파일 지원: 이 기능은 휴대 장치에서는 지원되지만 데스크톱 운영 체제 또는 AIR for TV 장치에서는 지원되지 않습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.

CameraRoll.addBitmapData() 메서드는 장치의 전용 미디어 라이브러리에 이미지를 추가합니다. 응용 프로그램에서 CameraRoll.addBitmapData() 메서드를 지원하는지 런타임에 확인하려면 CameraRoll.supportsAddBitmapData 속성을 확인하십시오.

CameraRoll.browseForImage() 메서드는 사용자가 미디어 라이브러리에서 이미지를 선택할 수 있도록 하는 이미지 선택 대화 상자를 엽니다. 사용자가 이미지를 선택할 때 CameraRoll 객체는 select 이벤트를 전달합니다. 이 이벤트에 대해 전달된 MediaEvent 객체를 사용하여 선택한 이미지에 액세스합니다. 응용 프로그램에서 CameraRoll.browseForImage() 메서드를 지원하는지 런타임에서 확인하려면 CameraRoll.supportsBrowseForImage 속성을 확인하십시오.



공용 속성
 속성정의 주체
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
      permissionStatus : String
[정적] [읽기 전용] 응용 프로그램에 카메라 롤에 액세스할 수 있는 권한이 부여되었는지 여부를 확인합니다.
CameraRoll
      supportsAddBitmapData : Boolean
[정적] [읽기 전용] CameraRoll.addBitmapData() 메서드가 지원되는지 여부입니다.
CameraRoll
      supportsBrowseForImage : Boolean
[정적] [읽기 전용] CameraRoll.browseForImage() 메서드가 지원되는지 여부를 보고합니다.
CameraRoll
공용 메서드
 메서드정의 주체
  
    CameraRoll()
CameraRoll 객체를 만듭니다.
CameraRoll
  
    addBitmapData(bitmapData:BitmapData):void
장치 카메라 롤에 이미지를 추가합니다.
CameraRoll
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
  
사용자가 장치 카메라 롤에서 기존 이미지를 선택할 수 있도록 이미지 브라우저 대화 상자를 엽니다.
CameraRoll
 Inherited
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
 Inherited
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
  
시스템 미디어 라이브러리 또는 "카메라 롤"에 액세스할 수 있는 권한을 요청합니다.
CameraRoll
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 정의 주체
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
  
    cancel
사용자가 이미지를 선택하지 않고 이미지 탐색 작업을 취소할 때 전달됩니다.CameraRoll
  
    complete
addBitmapData() 작업이 성공적으로 완료되었음을 알립니다.CameraRoll
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
  
    error
error 이벤트는 오류가 발생할 때 전달됩니다.CameraRoll
  응용 프로그램이 카메라 롤에 액세스할 수 있는 권한을 요청할 때 전달됩니다.CameraRoll
  
    select
사용자가 장치 미디어 라이브러리에서 이미지를 선택할 때 전달됩니다.CameraRoll
속성 세부 정보
    

permissionStatus

속성
permissionStatus:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 24.0

응용 프로그램에 카메라 롤에 액세스할 수 있는 권한이 부여되었는지 여부를 확인합니다.



구현
    public static function get permissionStatus():String

관련 API 요소

    

supportsAddBitmapData

속성 
supportsAddBitmapData:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 2

CameraRoll.addBitmapData() 메서드가 지원되는지 여부입니다. 현재 이 기능은 휴대 장치의 AIR 응용 프로그램에서만 지원됩니다.



구현
    public static function get supportsAddBitmapData():Boolean
    

supportsBrowseForImage

속성 
supportsBrowseForImage:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 2.5

CameraRoll.browseForImage() 메서드가 지원되는지 여부를 보고합니다. 현재 이 기능은 휴대 장치의 AIR 응용 프로그램에서만 지원됩니다.



구현
    public static function get supportsBrowseForImage():Boolean
생성자 세부 정보
    

CameraRoll

()생성자
public function CameraRoll()

언어 버전: ActionScript 3.0
런타임 버전: AIR 2

CameraRoll 객체를 만듭니다.

ActionScript에 의해 지원되는 미디어 라이브러리는 하나뿐입니다. 모든 CameraRoll 객체는 동일한 이미지 저장소에 저장됩니다.

메서드 세부 정보

    addBitmapData

()메서드
public function addBitmapData(bitmapData:BitmapData):void

언어 버전: ActionScript 3.0
런타임 버전: AIR 2

장치 카메라 롤에 이미지를 추가합니다.

응용 프로그램에서 CameraRoll.addBitmapData() 메서드를 지원하는지 런타임에 확인하려면 CameraRoll.supportsAddBitmapData 속성을 확인하십시오.

매개 변수

bitmapData:BitmapData — 카메라 롤에 보낼 이미지가 포함된 BitmapData 객치입니다.


오류
PermissionError — 응용 프로그램에 카메라를 사용할 수 있는 권한이 없습니다.

    browseForImage

()메서드 
public function browseForImage(value:CameraRollBrowseOptions = null):void

언어 버전: ActionScript 3.0
런타임 버전: AIR 2.5

사용자가 장치 카메라 롤에서 기존 이미지를 선택할 수 있도록 이미지 브라우저 대화 상자를 엽니다.

사용자가 이미지를 선택할 때 이 CameraRoll 인스턴스는 MediaEvent 객체를 포함하는 select 이벤트를 전달합니다. MediaEvent 객체의 data 속성을 사용하여 이미지를 로드합니다. data 속성은 MediaPromise 객체로서, Loader 클래스의 loadFilePromise() 메서드를 사용하여 로드할 수 있습니다. MediaPromise 객체는 일부 플랫폼(Blackberry Tablet OS)에서는 유효한 파일 객체를 포함하지만 다른 플랫폼(iOS 및 Android)에서는 포함하지 않습니다. loadFilePromise() 메서드를 사용할 경우 이미지는 모든 플랫폼에서 올바르게 로드됩니다. 미디어 객체의 원시 데이터에 액세스하려면 미디어 프로미스가 제공하는 데이터 소스를 열고 IDataInput 인터페이스의 메서드를 사용하여 데이터를 읽습니다.

응용 프로그램이 CameraRoll.browseForImage() 메서드를 지원하는지 여부를 런타임에 확인하려면 CameraRoll.supportsBrowseForImage 속성을 확인하십시오.

iOS(iPad만 해당)에서는 이미지 브라우저 대화 상자에 대한 특정 크기를 요청할 수 있습니다. 이미지 브라우저 대화 상자로 덮지 않으려는 화면 영역을 지정할 수도 있습니다. iPad 장치에서는 이미지 브라우저가 전체 화면을 차지하지 않으므로 이 요청은 iPad에서만 작동합니다.

iPad의 경우 이미지 브라우저에 대한 크기 및 배치 옵션을 요청하려면 CameraRollBrowseOptions 객체를 browseForImage()에 전달합니다. 매개 변수가 없을 경우 이 메서드는 대화 상자 크기에 대한 시스템 기본값을 사용하여 표시의 왼쪽 위 모서리에 대화 상자를 배치합니다.

매개 변수

value:CameraRollBrowseOptions (default = null) — 이미지 롤 대화 상자를 표시하기 위한 옵션을 지정하는 데 사용할 수 있는 CameraRollBrowseOptions 객체입니다. 이 매개 변수는 선택적입니다.


이벤트
select:MediaEvent — 사용자가 이미지를 선택할 때 전달됩니다.
 
cancel:Event — 사용자가 탐색 작업을 취소할 때 전달됩니다.
 
error:ErrorEvent — 기본 이미지 브라우저 응용 프로그램이 이미 사용 중일 경우 전달됩니다.
 
error:ErrorEvent — AIR 응용 프로그램이 백그라운드에서 이 함수를 호출할 경우 전달됩니다.

오류
PermissionError — 응용 프로그램에 카메라를 사용할 수 있는 권한이 없습니다.

추가 정보

관련 API 요소


예제  ( 예제 사용 방법 )

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

    requestPermission

()메서드 
public function requestPermission():void

언어 버전: ActionScript 3.0
런타임 버전: AIR 24.0

시스템 미디어 라이브러리 또는 "카메라 롤"에 액세스할 수 있는 권한을 요청합니다.


이벤트
PermissionStatus:PermissionEvent — 사용자가 요청된 권한을 부여/거부할 때 전달됩니다.
이벤트 세부 정보
    

cancel

이벤트
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.CANCEL

언어 버전: ActionScript 3.0
런타임 버전: AIR 2.5

사용자가 이미지를 선택하지 않고 이미지 탐색 작업을 취소할 때 전달됩니다.

Event.CANCEL 상수는 cancel 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target작업이 취소된 객체에 대한 참조입니다.
    

complete

이벤트  
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.COMPLETE

언어 버전: ActionScript 3.0
런타임 버전: AIR 2

addBitmapData() 작업이 성공적으로 완료되었음을 알립니다.

Event.COMPLETE 상수는 complete 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target로드가 완료된 네트워크 객체입니다.
    

error

이벤트  
이벤트 객체 유형: flash.events.ErrorEvent
속성 ErrorEvent.type = flash.events.ErrorEvent.ERROR

언어 버전: ActionScript 3.0
런타임 버전: AIR 2

error 이벤트는 오류가 발생할 때 전달됩니다.

오류의 소스는 다음과 같습니다.

  • 이미지 브라우저를 열 수 없습니다.
  • 이미지 브라우저가 이미 사용 중입니다.
  • AIR 응용 프로그램이 백그라운드로 이미지 탐색을 시도합니다.
  • 미디어 라이브러리에 이미지를 추가할 수 없습니다.
  • 장치에서 지원되지 않는 메서드가 호출됩니다.
  • AIR 응용 프로그램이 인터넷에 연결되지 않은 상태에서 원격 이미지를 로드하려고 합니다.

error 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target네트워크 작업에 실패한 객체입니다.
text오류 메시지로 표시될 텍스트입니다.
    

permissionStatus

이벤트  
이벤트 객체 유형: flash.events.PermissionEvent
속성 PermissionEvent.type = flash.events.PermissionEvent.PERMISSION_STATUS

언어 버전: ActionScript 3.0
런타임 버전: AIR 24.0

응용 프로그램이 카메라 롤에 액세스할 수 있는 권한을 요청할 때 전달됩니다. status 속성 값을 검사하여 권한이 부여되었는지 아니면 거부되었는지 확인합니다.

관련 API 요소

    

select

이벤트  
이벤트 객체 유형: flash.events.MediaEvent
속성 MediaEvent.type = flash.events.MediaEvent.SELECT

언어 버전: ActionScript 3.0
런타임 버전: AIR 2.5

사용자가 장치 미디어 라이브러리에서 이미지를 선택할 때 전달됩니다.

이 이벤트에 대해 전달된 MediaEvent 객체를 사용하여 선택한 미디어에 액세스할 수 있습니다.

select MediaEvent에 대한 상수입니다.

MediaEvent 이벤트 객체의 type 속성 값을 정의합니다. 이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
data사용 가능한 미디어 인스턴스의 MediaPromise 객체입니다.




[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.