패키지 | flash.media |
클래스 | public class CameraRoll |
상속 | CameraRoll EventDispatcher Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2 |
AIR 프로파일 지원: 이 기능은 휴대 장치에서는 지원되지만 데스크톱 운영 체제 또는 AIR for TV 장치에서는 지원되지 않습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
CameraRoll.addBitmapData()
메서드는 장치의 전용 미디어 라이브러리에 이미지를 추가합니다. 응용 프로그램에서 CameraRoll.addBitmapData()
메서드를 지원하는지 런타임에 확인하려면 CameraRoll.supportsAddBitmapData
속성을 확인하십시오.
CameraRoll.browseForImage()
메서드는 사용자가 미디어 라이브러리에서 이미지를 선택할 수 있도록 하는 이미지 선택 대화 상자를 엽니다. 사용자가 이미지를 선택할 때 CameraRoll 객체는 select
이벤트를 전달합니다. 이 이벤트에 대해 전달된 MediaEvent 객체를 사용하여 선택한 이미지에 액세스합니다. 응용 프로그램에서 CameraRoll.browseForImage()
메서드를 지원하는지 런타임에서 확인하려면 CameraRoll.supportsBrowseForImage
속성을 확인하십시오.
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
permissionStatus : String [정적] [읽기 전용]
응용 프로그램에 카메라 롤에 액세스할 수 있는 권한이 부여되었는지 여부를 확인합니다. | CameraRoll | ||
supportsAddBitmapData : Boolean [정적] [읽기 전용]
CameraRoll.addBitmapData() 메서드가 지원되는지 여부입니다. | CameraRoll | ||
supportsBrowseForImage : Boolean [정적] [읽기 전용]
CameraRoll.browseForImage() 메서드가 지원되는지 여부를 보고합니다. | CameraRoll |
메서드 | 정의 주체 | ||
---|---|---|---|
CameraRoll 객체를 만듭니다. | CameraRoll | ||
장치 카메라 롤에 이미지를 추가합니다. | CameraRoll | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
사용자가 장치 카메라 롤에서 기존 이미지를 선택할 수 있도록 이미지 브라우저 대화 상자를 엽니다. | CameraRoll | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
시스템 미디어 라이브러리 또는 "카메라 롤"에 액세스할 수 있는 권한을 요청합니다. | CameraRoll | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
이벤트 | 요약 | 정의 주체 | ||
---|---|---|---|---|
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | |||
사용자가 이미지를 선택하지 않고 이미지 탐색 작업을 취소할 때 전달됩니다. | CameraRoll | |||
addBitmapData() 작업이 성공적으로 완료되었음을 알립니다. | CameraRoll | |||
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | |||
error 이벤트는 오류가 발생할 때 전달됩니다. | CameraRoll | |||
응용 프로그램이 카메라 롤에 액세스할 수 있는 권한을 요청할 때 전달됩니다. | CameraRoll | |||
사용자가 장치 미디어 라이브러리에서 이미지를 선택할 때 전달됩니다. | CameraRoll |
permissionStatus | 속성 |
supportsAddBitmapData | 속성 |
supportsBrowseForImage | 속성 |
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: — 사용자가 이미지를 선택할 때 전달됩니다.
| |
cancel: — 사용자가 탐색 작업을 취소할 때 전달됩니다.
| |
error: — 기본 이미지 브라우저 응용 프로그램이 이미 사용 중일 경우 전달됩니다.
| |
error: — 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: — 사용자가 요청된 권한을 부여/거부할 때 전달됩니다.
|
cancel | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.CANCEL
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2.5 |
사용자가 이미지를 선택하지 않고 이미지 탐색 작업을 취소할 때 전달됩니다.
Event.CANCEL
상수는 cancel
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 작업이 취소된 객체에 대한 참조입니다. |
complete | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.COMPLETE
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2 |
addBitmapData() 작업이 성공적으로 완료되었음을 알립니다.
Event.COMPLETE
상수는 complete
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | 로드가 완료된 네트워크 객체입니다. |
error | 이벤트 |
flash.events.ErrorEvent
속성 ErrorEvent.type =
flash.events.ErrorEvent.ERROR
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2 |
error
이벤트는 오류가 발생할 때 전달됩니다.
오류의 소스는 다음과 같습니다.
- 이미지 브라우저를 열 수 없습니다.
- 이미지 브라우저가 이미 사용 중입니다.
- AIR 응용 프로그램이 백그라운드로 이미지 탐색을 시도합니다.
- 미디어 라이브러리에 이미지를 추가할 수 없습니다.
- 장치에서 지원되지 않는 메서드가 호출됩니다.
- AIR 응용 프로그램이 인터넷에 연결되지 않은 상태에서 원격 이미지를 로드하려고 합니다.
error
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
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
속성 값을 정의합니다. 이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
data | 사용 가능한 미디어 인스턴스의 MediaPromise 객체입니다. |
Tue Jun 12 2018, 03:17 PM Z