ExtensionContext  - AS3

이 컨텍스트와 연결된 ActionScript 객체입니다(있는 경우).

어떠한 ActionScript 객체라도 ExtensionContext 인스턴스와 연결할 수 있습니다. 기본 구현은 이 ActionScript 객체를 가져오고 설정할 수도 있습니다. 따라서 actionScriptData를 사용하여 확장의 ActionScript 측과 기본 구현 측 간에 데이터를 공유할 수 있습니다.

actionScriptData의 값을 null로 설정할 수도 있습니다.

functionName에 의해 지정된 기본 함수를 호출합니다. 추가 인수는 기본 함수에 전달됩니다.

매개 변수

지정된 확장 식별자 및 컨텍스트 유형에 대해 ExtensionContext 인스턴스를 만듭니다.

매개 변수

ExtensionContext 인스턴스를 지웁니다.

런타임이 기본 구현을 알리면, 이를 통해 연결된 기본 리소스를 해제할 수 있습니다. dispose()를 호출한 후에는 코드가 call() 메서드를 호출할 수 없으며, actionScriptData 속성을 가져오거나 설정할 수 없습니다.

장치에서 확장이 설치된 디렉토리를 반환합니다.

확장의 ActionScript 코드에서 액세스하려는 이미지 등의 리소스가 확장에 포함되어 있는 경우도 있습니다. 때로는 확장 버전 번호 등 확장 설명자 파일에서 사용할 수 있는 정보도 코드에 필요합니다. 이 메서드를 사용하여 확장의 기본 디렉토리에 액세스할 수 있습니다.

장치에서 확장의 위치에 관계없이 확장의 파일은 확장의 이 기본 디렉토리를 기준으로 항상 동일한 위치에 있습니다. 이 메서드가 반환하는 File 인스턴스를 사용하면 확장에 포함된 특정 파일을 탐색하고 조작할 수 있습니다.

확장 디렉토리의 구조는 다음과 같습니다.

			 extension base directory/
			      platform independent files
			      META-INF/
			           ANE/
			                extension.xml
			                platform name/
			                     platform-dependent files and directories
			 

확장 디렉토리 위치는 확장이 응용 프로그램 번들링을 통해 제공되는지 아니면 장치 번들링을 통해 제공되는지에 따라 다름과 같습니다.

• 응용 프로그램 번들링의 경우 확장 디렉토리의 위치는 응용 프로그램 디렉토리 내부입니다.
• 장치 번들링의 경우 확장 디렉토리의 위치는 장치에 따라 다릅니다.

iOS 장치용 기본 확장의 경우 getExtensionDirectory() 사용에 대해 예외가 있습니다. 이러한 확장의 리소스는 확장 디렉토리에 있지 않으며 최상위 응용 프로그램 디렉토리에 있습니다.

매개 변수

ExtensionContext 클래스는 Adobe AIR 기본 확장의 기본 구현에 있는 기능을 호출하는 데 사용할 수 있는 인터페이스를 제공합니다. 확장에 포함된 ActionScript 클래스에서만 이 클래스를 사용할 수 있습니다.

AIR 프로파일 지원: AIR 3부터 시작하여 이 기능은 휴대 장치에서 지원됩니다. AIR 3부터 시작하여 extendedDesktop 장치 프로파일을 사용하는 데스크톱 장치의 응용 프로그램에서도 지원됩니다. AIR 2.5부터 시작하여 extendedTV 장치 프로파일을 사용하는 AIR for TV 장치의 응용 프로그램에서 지원됩니다.

기본 확장의 구성 요소:

• ActionScript 클래스.
• 기본 코드. 기본 코드는 런타임 외부의 장치에서 실행되는 코드입니다. 예를 들어 C에 작성하는 코드가 기본 코드입니다.

기본 확장을 만들어 다음을 수행할 수 있습니다.

• AIR 응용 프로그램에 장치별 기능에 대한 액세스를 제공합니다.
• 기존 기본 코드를 재사용합니다.
• 기본 코드를 사용하여 ActionScript 코드보다 효율적인 처리를 제공합니다.

확장의 ActionScript 측에서 ExtensionContext 클래스를 사용하여 확장의 기본 구현 측에 액세스합니다. 먼저, ExtensionContext 클래스의 인스턴스를 만듭니다. 이렇게 하려면 정적 메서드 ExtensionContext.createExtensionContext()를 호출합니다.

ExtensionContext 인스턴스를 만든 후에 인스턴스의 call() 메서드를 사용하여 기본 함수를 호출합니다.

ExtensionContext 인스턴스에 대한 작업을 마쳤으면 dispose()를 호출하여 연결된 기본 리소스를 해제합니다. 명시적인 dispose() 호출 없이 런타임 가비지 수집기는 인스턴스를 지울 때 dispose()를 호출합니다. 명시적인 dispose() 호출은 일반적으로 가비지 수집기를 기다리기 훨씬 전에 수행됩니다.

ExtensionContext 인스턴스는 기본으로 구현된 확장에서 일부 비동기적 이벤트가 발생할 때 기본 코드가 전달하는 StatusEvent 이벤트를 수신할 수 있습니다. ExtensionContext 클래스는 EventDispatcher에서 파생되기 때문에 이벤트를 전달할 수 있습니다.

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