TV용 AIR 응용 프로그램 설명자 속성

다른 AIR 응용 프로그램에서와 마찬가지로 응용 프로그램 설명자 파일에서 기본 응용 프로그램 속성을 설정합니다. TV 프로파일 응용 프로그램은 윈도우 크기, 투명도 등 일부 데스크톱 관련 속성을 무시합니다. extendedTV 프로파일에서 장치를 대상으로 하는 응용 프로그램은 기본 확장을 사용할 수 있습니다. 이러한 응용 프로그램은 extensions 요소에서 사용된 기본 확장을 식별합니다.

공통 설정

모든 TV 프로파일 응용 프로그램에서 중요한 여러 가지 응용 프로그램 설명자 설정이 있습니다.

필요한 AIR 런타임 버전

응용 프로그램 설명자 파일의 네임스페이스를 사용하여 응용 프로그램에 필요한 AIR 런타임의 버전을 지정합니다.

응용 프로그램에서 사용할 수 있는 기능을 결정하는 데 가장 큰 영향을 미치는 것은 application 요소에 할당된 네임스페이스입니다. 예를 들어 AIR 2.5 네임스페이스를 사용하지만 사용자가 특정 이후 버전을 설치한 응용 프로그램을 가정해 보십시오. 이 경우 이후의 AIR 버전에서 비헤이비어가 다르지만 응용 프로그램은 여전히 AIR 2.5 비헤이비어를 인식합니다. 네임스페이스를 변경하고 업데이트를 제작할 경우에만 응용 프로그램이 새로운 비헤이비어 및 기능에 액세스할 수 있습니다. 보안 픽스는 이 규칙에 대한 중요한 예외입니다.

루트 application 요소의 xmlns 특성을 사용하여 네임스페이스를 지정합니다.

<application xmlns="http://ns.adobe.com/air/application/2.5">

AIR 2.5는 TV 응용 프로그램을 지원하는 최초의 AIR 버전입니다.

응용 프로그램 ID

제작하는 각 응용 프로그램에 대해 여러 설정이 고유해야 합니다. 이러한 설정에는 id , name filename 요소가 포함됩니다.

<id>com.example.MyApp</id> 
<name>My Application</name> 
<filename>MyApplication</filename>

응용 프로그램 버전

versionNumber 요소에서 응용 프로그램 버전을 지정합니다. versionNumber 값을 지정할 때는 최대 세 개의 숫자로 이루어진 시퀀스를 사용할 수 있으며, 이때 각 숫자는 점으로 분리해야 합니다(예: “0.1.2”). 버전 번호의 각 세그먼트는 최대 세 자리까지 가능합니다. 즉, “999.999.999”가 허용되는 가장 큰 버전 번호입니다. 번호에 세 세그먼트를 모두 포함해야 하는 것은 아닙니다. 따라서 “1” 및 “1.0”도 유효한 버전 번호입니다.

versionLabel 요소를 사용하여 버전에 대한 레이블을 지정할 수도 있습니다. 버전 레이블을 추가하면 버전 번호 대신 표시됩니다.

<versionNumber>1.23.7<versionNumber> 
<versionLabel>1.23 Beta 7</versionLabel>

기본 응용 프로그램 SWF

initialWindow 요소의 versionLabel 자식에서 기본 응용 프로그램 SWF 파일을 지정합니다. TV 프로파일에 있는 장치를 대상으로 삼을 때는 SWF 파일을 사용해야 합니다(HTML 기반 응용 프로그램은 지원되지 않음).

<initialWindow> 
    <content>MyApplication.swf</content> 
</initialWindow>

파일을 AIR 패키지에 포함해야 합니다(ADT 또는 IDE 사용). 단순히 응용 프로그램 설명자에 있는 이름을 참조하는 것만으로는 파일이 패키지에 자동으로 포함되지 않습니다.

기본 화면 속성

initialWindow 요소의 여러 자식 요소는 기본 응용 프로그램 화면의 초기 모양 및 비헤이비어를 제어합니다. 이들 속성 중 대부분은 TV 프로파일에 있는 장치에서 무시되지만 fullScreen 요소는 사용할 수 있습니다.

  • fullScreen - 응용 프로그램이 전체 장치 디스플레이를 차지해야 하는지 아니면 일반 운영 체제 크롬과 디스플레이를 공유해야 하는지를 지정합니다.

    <fullScreen>true</fullScreen>

visible 요소

visible 요소는 initialWindow 요소의 자식 요소입니다. TV용 AIR 장치에는 응용 프로그램의 내용이 항상 표시되기 때문에 TV용 AIR에서는 visible 요소를 무시합니다.

하지만 응용 프로그램에서 데스크톱 장치를 대상으로 지정한 경우에는 visible 요소를 true 로 설정합니다.

데스크톱 장치에서는 이 요소의 값이 기본적으로 false 로 지정됩니다. 따라서 visible 요소를 포함하지 않으면 데스크톱 장치에서 응용 프로그램의 내용이 표시되지 않습니다. ActionScript 클래스인 NativeWindow를 사용하여 데스크톱 장치에 내용을 표시할 수 있지만 TV 장치 프로파일에서는 NativeWindow 클래스를 지원하지 않습니다. 따라서 TV용 AIR 장치에서 실행되는 응용 프로그램에서 NativeWindow 클래스를 사용하려고 하면 응용 프로그램이 로드되지 않습니다. NativeWindow 클래스의 메서드를 호출하는지 여부와 관계없이 이 클래스를 사용하는 응용 프로그램은 TV용 AIR 장치에 로드되지 않습니다.

지원되는 프로파일

응용 프로그램이 TV 장치에서만 작동하는 경우에는 다른 유형의 컴퓨팅 장치에 설치되는 것을 방지할 수 있습니다. supportedProfiles 요소의 지원되는 목록에서 다른 프로파일을 제외합니다.

<supportedProfiles>tv extendedTV</supportedProfiles>

응용 프로그램에서 기본 확장을 사용하는 경우 지원되는 프로파일 목록에 extendedTV 프로파일만 포함합니다.

<supportedProfiles>extendedTV</supportedProfiles>

supportedProfiles 요소를 생략하면 응용 프로그램이 모든 프로파일을 지원하는 것으로 가정합니다.

supportedProfiles 목록에 tv 프로파일만 포함해서는 안 됩니다. 일부 TV 장치에서는 TV용 AIR를 항상 extendedTV 프로파일에 해당하는 모드로 실행합니다. 이 비헤이비어는 TV용 AIR가 기본 확장을 사용하는 응용 프로그램을 실행할 수 있도록 하기 위한 것입니다. supportedProfiles 요소가 tv 만 지정하는 경우에는 내용이 extendedTV 에 대한 TV용 AIR 모드와 호환되지 않음을 알리는 것입니다. 따라서 일부 TV 장치에서는 tv 프로파일만 지정하는 응용 프로그램을 로드하지 않습니다.

tv extendedTV 프로파일에서 지원되는 ActionScript 클래스의 목록에 대해서는 각 프로파일의 기능 을 참조하십시오.

필수 기본 확장

extendedTV 프로파일을 지원하는 응용 프로그램에서는 기본 확장을 사용할 수 있습니다.

extensions extensionID 요소를 사용하여 AIR 응용 프로그램이 응용 프로그램 설명자에서 사용하는 모든 기본 확장을 선언합니다. 다음 예제에서는 두 개의 필수 기본 확장을 지정하기 위한 구문을 보여 줍니다.

<extensions> 
     <extensionID>com.example.extendedFeature</extensionID> 
    <extensionID>com.example.anotherFeature</extensionID> 
</extensions>

확장이 목록에 없는 경우에는 응용 프로그램에서 해당 확장을 사용할 수 없습니다.

extensionID 요소의 값은 확장 설명자 파일에서 id 요소의 값과 동일합니다. 확장 설명자 파일은 extension.xml이라는 XML 파일로, 장치 제조업체로부터 받는 ANE 파일에 패키지화되어 있습니다.

extensions 요소에 확장을 지정하지만 TV용 AIR 장치에 확장이 설치되어 있지 않으면 응용 프로그램을 실행할 수 없습니다. TV용 AIR 응용 프로그램과 패키지화하는 ANE 파일에 스텁 버전의 확장이 있는 경우에는 이러한 규칙이 적용되지 않습니다. 이 경우 응용 프로그램을 실행할 수 있고 응용 프로그램에서 스텁 버전의 확장을 사용합니다. 스텁 버전에는 ActionScript 코드는 있지만 기본 코드는 없습니다.

응용 프로그램 아이콘

TV 장치에서 응용 프로그램 아이콘에 대한 요구 사항은 장치마다 다릅니다. 예를 들어 장치 제조업체는 다음을 지정합니다.
  • 필수 아이콘 및 아이콘 크기

  • 필수 파일 유형 및 명명 규칙

  • 아이콘을 응용 프로그램과 함께 패키지화하는지 여부 등 응용 프로그램의 아이콘을 제공하는 방법

  • 응용 프로그램 설명자 파일의 icon 요소에서 아이콘을 지정하는지 여부

  • 응용 프로그램에서 아이콘을 제공하지 않을 경우의 비헤이비어

자세한 내용은 장치 제조업체에 문의하십시오.

무시되는 설정

TV 장치의 응용 프로그램은 모바일, 기본 윈도우 또는 데스크톱 운영 체제 기능에 적용되는 응용 프로그램 설정을 무시합니다. 무시되는 설정은 다음과 같습니다.

  • allowBrowserInvocation

  • aspectRatio

  • autoOrients

  • customUpdateUI

  • fileTypes

  • height

  • installFolder

  • maximizable

  • maxSize

  • minimizable

  • minSize

  • programMenuFolder

  • renderMode

  • resizable

  • systemChrome

  • title

  • transparent

  • visible

  • width

  • x

  • y