| 런타임 버전: | AIR 1.0 Flash Player 9 |
Capabilities 클래스에서는 SWF 파일을 호스팅하는 시스템 및 플레이어를 설명하는 속성을 제공합니다. 예를 들어 휴대폰 화면은 흑백 100제곱 픽셀일 수 있고 PC 화면은 컬러 1000제곱 픽셀일 수 있습니다. Capabilities 객체를 통해 사용자의 장치 유형을 확인하면 최대한 많은 사용자에게 적절한 콘텐츠를 제공할 수 있습니다. 장치의 성능을 파악하면 서버에서 적절한 SWF 파일을 보내도록 지시하거나 SWF 파일에서 프리젠테이션을 변경하도록 지시할 수 있습니다.
GET 또는 POST HTTP 메서드를 사용하여 Capabilities.serverString 속성에 URL 인코딩 문자열로 저장된 성능 정보를 보낼 수 있습니다. 다음 예제에서는 IME(input method editor)가 설치된 Windows XP가 실행 중이고 MP3가 지원되며 해상도가 1600 x 1200픽셀인 컴퓨터의 서버 문자열을 보여 줍니다.
A=t&SA=t&SV=t&EV=t&MP3=t&AE=t&VE=t&ACC=f&PR=t&SP=t&
SB=f&DEB=t&V=WIN%209%2C0%2C0%2C0&M=Adobe%20Windows&
R=1600x1200&DP=72&COL=color&AR=1.0&OS=Windows%20XP&
L=en&PT=External&AVD=f&LFD=f&WD=f&IME=t
다음 표에서는 Capabilities 클래스의 속성과 해당 서버 문자열을 나열합니다.
| Capabilities 클래스 속성 | 서버 문자열 |
|---|
avHardwareDisable
|
AVD
|
hasAccessibility
|
ACC
|
hasAudio
|
A
|
hasAudioEncoder
|
AE
|
hasEmbeddedVideo
|
EV
|
hasIME
|
IME
|
hasMP3
|
MP3
|
hasPrinting
|
PR
|
hasScreenBroadcast
|
SB
|
hasScreenPlayback
|
SP
|
hasStreamingAudio
|
SA
|
hasStreamingVideo
|
SV
|
hasTLS
|
TLS
|
hasVideoEncoder
|
VE
|
isDebugger
|
DEB
|
language
|
L
|
localFileReadDisable
|
LFD
|
manufacturer
|
M
|
maxLevelIDC
|
ML
|
os
|
OS
|
pixelAspectRatio
|
AR
|
playerType
|
PT
|
screenColor
|
COL
|
screenDPI
|
DP
|
screenResolutionX
|
R
|
screenResolutionY
|
R
|
version
|
V
|
Capabilities 클래스의 모든 속성은 읽기 전용입니다.
예제 보기
avHardwareDisable:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
사용자의 카메라와 마이크에 대한 액세스가 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. 서버 문자열은 AVD입니다.
Adobe AIR™에 있는 내용의 경우 이 속성은 응용 프로그램 보안 샌드박스가 아닌 보안 샌드박스의 내용에만 적용됩니다. 응용 프로그램 보안 샌드박스의 내용은 항상 사용자의 카메라 및 마이크에 액세스할 수 있습니다.
구현 public static function get avHardwareDisable():Boolean참고 사항
hasAccessibility:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 액세스 가능성 도구와의 통신을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 ACC입니다.
구현 public static function get hasAccessibility():Boolean참고 사항
hasAudio:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에 오디오 기능이 있는지 여부를 지정합니다. 이 속성은 항상 true입니다. 서버 문자열은 A입니다.
구현 public static function get hasAudio():BooleanhasAudioEncoder:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 마이크 입력 등의 오디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false) 여부를 지정합니다. 서버 문자열은 AE입니다.
구현 public static function get hasAudioEncoder():BooleanhasEmbeddedVideo:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 포함된 비디오를 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 EV입니다.
구현 public static function get hasEmbeddedVideo():BooleanhasIME:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에 IME가 설치되어 있는지(true) 또는 설치되어 있지 않은지(false) 여부를 지정합니다. 서버 문자열은 IME입니다.
구현 public static function get hasIME():Boolean참고 사항
hasMP3:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에 MP3 디코더가 있는지(true) 또는 없는지(false) 여부를 지정합니다. 서버 문자열은 MP3입니다.
구현 public static function get hasMP3():Boolean참고 사항
hasPrinting:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 인쇄를 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 PR입니다.
구현 public static function get hasPrinting():BooleanhasScreenBroadcast:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 개발을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 SB입니다.
구현 public static function get hasScreenBroadcast():BooleanhasScreenPlayback:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램의 재생을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 SP입니다.
구현 public static function get hasScreenPlayback():BooleanhasStreamingAudio:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 스트리밍 오디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false) 여부를 지정합니다. 서버 문자열은 SA입니다.
구현 public static function get hasStreamingAudio():BooleanhasStreamingVideo:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 스트리밍 비디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false) 여부를 지정합니다. 서버 문자열은 SV입니다.
구현 public static function get hasStreamingVideo():BooleanhasTLS:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 NetConnection을 통한 기본 SSL 소켓을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 TLS입니다.
구현 public static function get hasTLS():Boolean참고 사항
hasVideoEncoder:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템에서 웹 카메라 입력 등의 비디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false) 여부를 지정합니다. 서버 문자열은 VE입니다.
구현 public static function get hasVideoEncoder():BooleanisDebugger:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
시스템이 특수 디버깅 버전인지(true) 또는 정식으로 출시된 버전인지(false) 여부를 지정합니다. 서버 문자열은 DEB입니다. Flash Player의 디버그 버전 또는 ADL(AIR Debug Launcher)에서 실행할 경우 이 속성은 true로 설정됩니다.
구현 public static function get isDebugger():BooleanisEmbeddedInAcrobat:Boolean [읽기 전용]
| 런타임 버전: | Flash Player 9.0.127.0, AIR 1.1 |
플레이어가 Acrobat 9.0 이상에서 열리는 PDF 파일에 포함되어 있는지 여부(true 또는 false)를 지정합니다.
구현 public static function get isEmbeddedInAcrobat():Boolean참고 사항
language:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
내용이 실행되는 시스템의 언어 코드를 지정합니다. 언어는 ISO 639-1에 소문자로 지정된 두 글자 언어 코드로 지정됩니다. 중국어의 경우 ISO 3166의 대문자로 된 두 글자 국가 코드가 추가되어 중국어 간체와 번체가 구별됩니다. 언어 코드는 해당 언어의 영어 이름에 기초합니다. 예를 들어 헝가리어는 hu로 지정됩니다.
영어 시스템에서 이 속성은 국가 코드가 아닌 언어 코드(en)만 반환합니다. Microsoft Windows 시스템에서 이 속성은 모든 메뉴, 대화 상자, 오류 메시지 및 도움말 파일에 사용되는 언어를 참조하는 UI(사용자 인터페이스) 언어를 반환합니다. 다음 표에는 가능한 값이 나열되어 있습니다.
| 언어 | 값 |
|---|
| 체코어 |
cs
|
| 덴마크어 |
da
|
| 네덜란드어 |
nl
|
| 영어 |
en
|
| 핀란드어 |
fi
|
| 프랑스어 |
fr
|
| 독일어 |
de
|
| 헝가리어 |
hu
|
| 이탈리아어 |
it
|
| 일본어 |
ja
|
| 한국어 |
ko
|
| 노르웨이어 |
no
|
| 기타/알 수 없음 |
xu
|
| 폴란드어 |
pl
|
| 포르투갈어 |
pt
|
| 러시아어 |
ru
|
| 중국어 간체 |
zh-CN
|
| 스페인어 |
es
|
| 스웨덴어 |
sv
|
| 중국어 번체 |
zh-TW
|
| 터키어 |
tr
|
참고: Capabilities.language 속성에는 이 목록의 값만 사용할 수 있습니다. 이러한 제한 사항으로 인해 Adobe AIR 응용 프로그램에서는 Capabilities.languages 배열의 첫 번째 요소를 사용하여 시스템의 기본 사용자 인터페이스 언어를 확인해야 합니다.
서버 문자열은 L입니다.
구현 public static function get language():String참고 사항
예제
다음 예제에서 표시되는 내용은 사용자 운영 체제의 언어에 따라 다릅니다.
Capabilities.language 속성은 ISO 639-1 언어 코드(예: 영어는 "en")를 반환합니다. switch 문은 언어 코드를 확인하고 myTextField 텍스트 필드의 내용을 해당 언어에 적합한 인사말로 설정합니다. 예제에서는 언어 코드를 지원하지 않을 경우 기본 오류 문자열이 반환됩니다.
package {
import flash.display.Sprite;
import flash.text.TextField;
import flash.text.TextFieldAutoSize;
import flash.system.Capabilities;
public class Capabilities_languageExample extends Sprite {
public function Capabilities_languageExample() {
var myTextField:TextField = new TextField();
myTextField.x = 10;
myTextField.y = 10;
myTextField.background = true;
myTextField.autoSize = TextFieldAutoSize.LEFT;
var greetingEnglish:String = "Hello World";
var greetingGerman:String = "Hallo Welt";
var greetingFrench:String = "Bonjour Monde";
var greetingSpanish:String = "Hola Mundo";
var lang:String = Capabilities.language;
switch (lang) {
case "en":
myTextField.text = greetingEnglish;
break;
case "de":
myTextField.text = greetingGerman;
break;
case "fr":
myTextField.text = greetingFrench;
break;
case "es":
myTextField.text = greetingSpanish;
break;
default:
myTextField.text = "Sorry your system's language is not supported at this time.";
}
this.addChild(myTextField);
}
}
}
languages:Array [읽기 전용]
사용자가 운영 체제를 통해 설정한 기본 설정 사용자 인터페이스 언어에 대한 정보가 들어 있는 문자열 배열입니다. 문자열에는 RFC4646 (http://www.ietf.org/rfc/rfc4646.txt)에 정의된 언어 태그 및 스크립트와 지역 정보(해당하는 경우)가 포함되며 대시가 구분 기호로 사용됩니다(예: "en-US" 또는 "ja-JP"). 각 언어는 배열에서 운영 체제 설정에 따른 선호 순서로 나열됩니다.
로캘 문자열에서 반환된 지역 정보에서 운영 체제가 다릅니다. 한 운영 체제에서 "en-us"를 반환하고 다른 운영 체제에서 "en"을 반환할 수 있습니다.
반환된 배열에 있는 첫 번째 항목의 기본 언어 ID는 일반적으로 Capabilities.language 속성의 기본 언어 ID와 동일합니다. 예를 들어 Capabilities.languages[0]가 "en-US"로 설정되면 language 속성은 "en"으로 설정됩니다. 그러나 Capabilities.language 속성을 알 수 없는 언어를 지정하는 "xu"로 설정하면 배열의 첫 번째 요소가 달라집니다. 따라서 Capabilities.languages[0]가 Capabilities.language보다 정확할 수 있습니다.
서버 문자열은 LS입니다.
구현 public static function get languages():ArraylocalFileReadDisable:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
사용자의 하드 디스크에 대한 읽기 액세스를 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. Adobe AIR에 있는 내용의 경우 이 속성은 응용 프로그램 보안 샌드박스가 아닌 보안 샌드박스의 내용에만 적용됩니다. 응용 프로그램 보안 샌드박스의 내용은 항상 파일 시스템에서 읽습니다. 이 속성이 true이면 Flash Player에서 Flash Player가 시작된 첫 번째 파일을 포함하여 사용자 하드 디스크의 파일을 읽을 수 없습니다. 이 속성이 true이면 응용 프로그램 보안 샌드박스 외부의 AIR 내용은 사용자 하드 디스크의 파일을 읽을 수 없습니다. 예를 들어 이 속성이 true로 설정되어 있으면 load 메서드를 통해 사용자의 하드 디스크에 있는 파일을 읽으려는 시도가 실패합니다.
이 속성이 true로 설정되면 런타임 공유 라이브러리 읽기도 차단되지만 로컬 공유 객체는 이 속성 값에 관계없이 읽을 수 있습니다.
서버 문자열은 LFD입니다.
구현 public static function get localFileReadDisable():Boolean참고 사항
manufacturer:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
실행 중인 Flash Player 또는 AIR 런타임 버전의 제조자를 "Adobe OSName" 형식으로 지정합니다. OSName 값은 "Windows", "Macintosh", "Linux" 또는 기타 운영 체제 이름이 될 수 있습니다. 서버 문자열은 M입니다.
구현 public static function get manufacturer():StringmaxLevelIDC:String [읽기 전용]
| 런타임 버전: | Flash Player 10, AIR 1.5 |
클라이언트 하드웨어가 지원하는 최상의 H.264 수준 IDC를 검색합니다. 이 수준에서 미디어를 실행하면 항상 실행되지만 최상의 수준에서 미디어를 실행하면 최상의 품질로 실행되지 않을 수도 있습니다. 이 속성은 클라이언트의 기능을 대상으로 지정하는 서버에 유용합니다. 이 속성을 사용하면 서버에서 클라이언트에 보낼 비디오의 수준을 결정할 수 있습니다.
서버 문자열은 ML입니다.
구현 public static function get maxLevelIDC():Stringos:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
현재 운영 체제를 지정합니다. os 속성은 "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE"(데스크톱 버전이 아닌 Flash Player SDK에서만 사용 가능), "Linux" 및 "Mac OS X.Y.Z"(X.Y.Z는 버전 번호. 예: Mac OS 10.5.2) 문자열을 반환할 수 있습니다. 서버 문자열은 OS입니다.
구현 public static function get os():StringpixelAspectRatio:Number [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
스크린의 픽셀 종횡비를 지정합니다. 서버 문자열은 AR입니다.
구현 public static function get pixelAspectRatio():NumberplayerType:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
런타임 환경의 유형을 지정합니다. 이 속성은 다음 값 중 하나를 가질 수 있습니다.
-
"ActiveX": Microsoft Internet Explorer에서 사용하는 Flash Player ActiveX 컨트롤의 경우
-
"Desktop": Adobe AIR 런타임의 경우(Capabilities.playerType이 "PlugIn"으로 설정된 HTML 페이지에서 로드한 SWF 내용 제외)
-
"External": 외부 Flash Player용 또는 테스트 모드의 경우
-
"PlugIn": Flash Player 브라우저 플러그인 및 AIR 응용 프로그램의 HTML 페이지에서 로드한 SWF 내용의 경우
-
"StandAlone": 독립 실행형 Flash Player의 경우
서버 문자열은 PT입니다.
구현 public static function get playerType():StringscreenColor:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
스크린 색상을 지정합니다. 이 속성의 값은 "color", "gray"(회색조) 또는 "bw"(흑백)일 수 있습니다. 서버 문자열은 COL입니다.
구현 public static function get screenColor():StringscreenDPI:Number [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
스크린의 dpi(인치당 도트 수) 해상도를 픽셀 단위로 지정합니다. 서버 문자열은 DP입니다.
구현 public static function get screenDPI():NumberscreenResolutionX:Number [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
스크린의 최대 수평 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다. 이 속성은 사용자의 화면 해상도로 업데이트되지 않고 대신 Flash Player 또는 Adobe AIR 응용 프로그램이 시작했을 때의 해상도만 표시합니다. 또한 이 값은 기본 모니터만 지정합니다.
구현 public static function get screenResolutionX():Number참고 사항
screenResolutionY:Number [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
스크린의 최대 수직 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다. 이 속성은 사용자의 화면 해상도로 업데이트되지 않고 대신 Flash Player 또는 Adobe AIR 응용 프로그램이 시작했을 때의 해상도만 표시합니다. 또한 이 값은 기본 모니터만 지정합니다.
구현 public static function get screenResolutionY():Number참고 사항
serverString:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
각 Capabilities 속성의 값을 지정하는 URL 인코딩 문자열입니다.
다음 예제는 URL 인코딩 문자열을 보여 줍니다.
A=t&SA=t&SV=t&EV=t&MP3=t&AE=t&VE=t&ACC=f&PR=t&SP=t&
SB=f&DEB=t&V=WIN%208%2C5%2C0%2C208&M=Adobe%20Windows&
R=1600x1200&DP=72&COL=color&AR=1.0&OS=Windows%20XP&
L=en&PT=External&AVD=f&LFD=f&WD=f
구현 public static function get serverString():String참고 사항
version:String [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9 |
Flash Player 또는 Adobe® AIR 플랫폼 및 버전 정보를 지정합니다. 버전 번호의 형식은 platform majorVersion, minorVersion, buildNumber, internalBuildNumber입니다. platform에 사용할 수 있는 값은 "WIN", "MAC" 및 "LNX"입니다. 버전 정보의 몇 가지 예는 다음과 같습니다.
WIN 9,0,0,0 // Flash Player 9 for Windows
MAC 7,0,25,0 // Flash Player 7 for Macintosh
LNX 9,0,115,0 // Flash Player 9 for Linux
서버 문자열은 V입니다.
구현 public static function get version():String참고 사항
다음 예제에서는
trace()를 몇 차례 호출하여 flash.system.Capabilities 객체에 있는 값을 출력합니다.
package {
import flash.display.Sprite;
import flash.system.Capabilities;
public class CapabilitiesExample extends Sprite {
public function CapabilitiesExample() {
showCapabilities();
}
private function showCapabilities():void {
trace("avHardwareDisable: " + Capabilities.avHardwareDisable);
trace("hasAccessibility: " + Capabilities.hasAccessibility);
trace("hasAudio: " + Capabilities.hasAudio);
trace("hasAudioEncoder: " + Capabilities.hasAudioEncoder);
trace("hasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo);
trace("hasMP3: " + Capabilities.hasMP3);
trace("hasPrinting: " + Capabilities.hasPrinting);
trace("hasScreenBroadcast: " + Capabilities.hasScreenBroadcast);
trace("hasScreenPlayback: " + Capabilities.hasScreenPlayback);
trace("hasStreamingAudio: " + Capabilities.hasStreamingAudio);
trace("hasVideoEncoder: " + Capabilities.hasVideoEncoder);
trace("isDebugger: " + Capabilities.isDebugger);
trace("language: " + Capabilities.language);
trace("localFileReadDisable: " + Capabilities.localFileReadDisable);
trace("manufacturer: " + Capabilities.manufacturer);
trace("os: " + Capabilities.os);
trace("pixelAspectRatio: " + Capabilities.pixelAspectRatio);
trace("playerType: " + Capabilities.playerType);
trace("screenColor: " + Capabilities.screenColor);
trace("screenDPI: " + Capabilities.screenDPI);
trace("screenResolutionX: " + Capabilities.screenResolutionX);
trace("screenResolutionY: " + Capabilities.screenResolutionY);
trace("serverString: " + Capabilities.serverString);
trace("version: " + Capabilities.version);
}
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 02:16 AM -08:00