| 패키지 | flash.system |
| 클래스 | public final class Capabilities |
| 상속 | Capabilities  Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
그러나 Adobe AIR의 일부 기능은 Capabilities 클래스에 속성으로 나열되지 않습니다. 다음은 다른 클래스의 속성입니다.
| 속성 | 설명 |
|---|---|
NativeApplication.supportsDockIcon
| 운영 체제가 응용 프로그램 도크 아이콘을 지원하는지 여부입니다. |
NativeApplication.supportsMenu
| 운영 체제가 전역 응용 프로그램 메뉴 모음을 지원하는지 여부입니다. |
NativeApplication.supportsSystemTrayIcon
| 운영 체제가 시스템 트레이 아이콘을 지원하는지 여부입니다. |
NativeWindow.supportsMenu
| 운영 체제가 윈도우 메뉴를 지원하는지 여부입니다. |
NativeWindow.supportsTransparency
| 운영 체제가 투명 윈도우를 지원하는지 여부입니다. |
운영 체제에 기반한 기능을 확인하기 위해 Capabilities.os 또는 Capabilities.manufacturer를 사용하지 마십시오. 기능이 운영 체제에 기반하도록 하면 응용 프로그램이 모든 잠재적 대상 운영 체제를 고려하지 않는 경우 문제가 발생할 수 있으므로 좋지 않습니다. 대신, 테스트하는 기능에 해당하는 속성을 사용하십시오.
GET 또는 POST HTTP 메서드를 사용하여 Capabilities.serverString 속성에 URL 인코딩 문자열로 저장된 성능 정보를 보낼 수 있습니다. 다음 예제에서는 MP3가 지원되고 해상도가 1600 x 1200픽셀이며 IME(Input Method Editor)가 설치된 Windows XP가 실행 중이고 다중 채널 오디오를 지원하지 않는 컴퓨터의 서버 문자열을 보여 줍니다.
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&DD=f&
DDP=f&DTS=f&DTE=f&DTH=f&DTM=f
다음 표에서는 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
|
Dolby Digital 오디오 지원
|
DD
|
Dolby Digital Plus 오디오 지원
|
DDP
|
DTS 오디오 지원
|
DTS
|
DTS Express 오디오 지원
|
DTE
|
DTS-HD High Resolution 오디오 지원
|
DTH
|
DTS-HD Master 오디오 지원
|
DTM
|
윈도우 없음 모드가 비활성화되어 있는지 여부를 지정하는 WD 서버 문자열도 있습니다. 윈도우 없음 모드는 웹 브라우저와의 비호환성 문제나 mms.cfg 파일의 사용자 설정으로 인해 Flash Player에서 비활성화될 수 있습니다. 해당하는 Capabilities 속성이 없습니다.
Capabilities 클래스의 모든 속성은 읽기 전용입니다.
기타 예제
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| avHardwareDisable : Boolean [정적] [읽기 전용]
사용자의 카메라와 마이크에 대한 액세스가 금지되었는지(true) 또는 허용되었는지(false) 여부를 지정합니다. | Capabilities | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| cpuArchitecture : String [정적] [읽기 전용]
현재 CPU 아키텍처를 지정합니다. | Capabilities | ||
| hasAccessibility : Boolean [정적] [읽기 전용]
시스템에서 액세스 가능성 도구와의 통신을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. | Capabilities | ||
| hasAudio : Boolean [정적] [읽기 전용]
시스템에 오디오 기능이 있는지 여부를 지정합니다. | Capabilities | ||
| hasAudioEncoder : Boolean [정적] [읽기 전용]
시스템에서 마이크 입력 등의 오디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false) 여부를 지정합니다. | Capabilities | ||
| hasEmbeddedVideo : Boolean [정적] [읽기 전용]
시스템에서 포함된 비디오를 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. | Capabilities | ||
| hasIME : Boolean [정적] [읽기 전용]
시스템에 IME가 설치되어 있는지(true) 또는 설치되어 있지 않은지(false) 여부를 지정합니다. | Capabilities | ||
| hasMP3 : Boolean [정적] [읽기 전용]
시스템에 MP3 디코더가 있는지(true) 또는 없는지(false) 여부를 지정합니다. | Capabilities | ||
| hasPrinting : Boolean [정적] [읽기 전용]
시스템에서 인쇄를 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. | Capabilities | ||
| hasScreenBroadcast : Boolean [정적] [읽기 전용]
시스템에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 개발을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. | Capabilities | ||
| hasScreenPlayback : Boolean [정적] [읽기 전용]
시스템에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램의 재생을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. | Capabilities | ||
| hasStreamingAudio : Boolean [정적] [읽기 전용]
시스템에서 스트리밍 오디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false) 여부를 지정합니다. | Capabilities | ||
| hasStreamingVideo : Boolean [정적] [읽기 전용]
시스템에서 스트리밍 비디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false) 여부를 지정합니다. | Capabilities | ||
| hasTLS : Boolean [정적] [읽기 전용]
시스템에서 NetConnection을 통한 기본 SSL 소켓을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. | Capabilities | ||
| hasVideoEncoder : Boolean [정적] [읽기 전용]
시스템에서 웹 카메라 입력 등의 비디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false) 여부를 지정합니다. | Capabilities | ||
| isDebugger : Boolean [정적] [읽기 전용]
시스템이 특수 디버깅 버전인지(true) 또는 정식으로 출시된 버전인지(false) 여부를 지정합니다. | Capabilities | ||
| isEmbeddedInAcrobat : Boolean [정적] [읽기 전용]
Flash 런타임이 Acrobat 9.0 이상에서 열리는 PDF 파일에 포함되어 있는지(true) 아니면 포함되어 있지 않은지(false)를 지정합니다. | Capabilities | ||
| language : String [정적] [읽기 전용]
내용이 실행되는 시스템의 언어 코드를 지정합니다. | Capabilities | ||
| languages : Array [정적] [읽기 전용]
사용자가 운영 체제를 통해 설정한 기본 설정 사용자 인터페이스 언어에 대한 정보가 들어 있는 문자열 배열입니다. | Capabilities | ||
| localFileReadDisable : Boolean [정적] [읽기 전용]
사용자의 하드 디스크에 대한 읽기 액세스가 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. | Capabilities | ||
| manufacturer : String [정적] [읽기 전용]
실행 중인 Flash Player 또는 AIR 런타임 버전의 제조자를 "Adobe OSName" 형식으로 지정합니다. | Capabilities | ||
| maxLevelIDC : String [정적] [읽기 전용]
클라이언트 하드웨어가 지원하는 최상의 H.264 수준 IDC를 검색합니다. | Capabilities | ||
| os : String [정적] [읽기 전용]
현재 운영 체제를 지정합니다. | Capabilities | ||
| pixelAspectRatio : Number [정적] [읽기 전용]
스크린의 픽셀 종횡비를 지정합니다. | Capabilities | ||
| playerType : String [정적] [읽기 전용]
런타임 환경의 유형을 지정합니다. | Capabilities | ||
| screenColor : String [정적] [읽기 전용]
스크린 색상을 지정합니다. | Capabilities | ||
| screenDPI : Number [정적] [읽기 전용]
스크린의 dpi(인치당 도트 수) 해상도를 픽셀 단위로 지정합니다. | Capabilities | ||
| screenResolutionX : Number [정적] [읽기 전용]
스크린의 최대 수평 해상도를 지정합니다. | Capabilities | ||
| screenResolutionY : Number [정적] [읽기 전용]
스크린의 최대 수직 해상도를 지정합니다. | Capabilities | ||
| serverString : String [정적] [읽기 전용]
각 Capabilities 속성의 값을 지정하는 URL 인코딩 문자열입니다. | Capabilities | ||
| supports32BitProcesses : Boolean [정적] [읽기 전용]
시스템이 32비트 프로세스 실행을 지원하는지 여부를 지정합니다. | Capabilities | ||
| supports64BitProcesses : Boolean [정적] [읽기 전용]
시스템이 64비트 프로세스 실행을 지원하는지 여부를 지정합니다. | Capabilities | ||
| touchscreenType : String [정적] [읽기 전용]
지원되는 터치 스크린이 있는 경우 터치 스크린의 유형을 지정합니다. | Capabilities | ||
| version : String [정적] [읽기 전용]
Flash Player 또는 Adobe® AIR® 플랫폼 및 버전 정보를 지정합니다. | Capabilities | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
[정적]
시스템에서 특정 유형의 다중 채널 오디오를 지원하는지 여부를 나타냅니다. | Capabilities | ||
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
avHardwareDisable | 속성 |
avHardwareDisable:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
사용자의 카메라와 마이크에 대한 액세스가 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. 서버 문자열은 AVD입니다.
Adobe AIR™에 있는 내용의 경우 이 속성은 응용 프로그램 보안 샌드박스가 아닌 보안 샌드박스의 내용에만 적용됩니다. 응용 프로그램 보안 샌드박스의 내용은 항상 사용자의 카메라 및 마이크에 액세스할 수 있습니다.
구현
public static function get avHardwareDisable():Boolean관련 API 요소
cpuArchitecture | 속성 |
hasAccessibility | 속성 |
hasAudio | 속성 |
hasAudioEncoder | 속성 |
hasEmbeddedVideo | 속성 |
hasIME | 속성 |
hasMP3 | 속성 |
hasPrinting | 속성 |
hasScreenBroadcast | 속성 |
hasScreenPlayback | 속성 |
hasStreamingAudio | 속성 |
hasStreamingVideo | 속성 |
hasTLS | 속성 |
hasVideoEncoder | 속성 |
isDebugger | 속성 |
isEmbeddedInAcrobat | 속성 |
language | 속성 |
language:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
내용이 실행되는 시스템의 언어 코드를 지정합니다. 언어는 ISO 639-1에 소문자로 지정된 두 글자 언어 코드로 지정됩니다. 중국어의 경우 ISO 3166의 대문자로 된 두 글자 국가 코드가 추가되어 중국어 간체와 번체가 구별됩니다. 언어 코드는 해당 언어의 영어 이름에 기초합니다. 예를 들어 헝가리어는 hu로 지정됩니다.
영어 시스템에서 이 속성은 국가 코드가 아닌 언어 코드(en)만 반환합니다. Microsoft Windows 시스템에서 이 속성은 모든 메뉴, 대화 상자, 오류 메시지 및 도움말 파일에 사용되는 언어를 참조하는 UI(사용자 인터페이스) 언어를 반환합니다. 다음 표에는 가능한 값이 나열되어 있습니다.
| 언어 | 값 |
|---|---|
| 체코어 | cs |
| 덴마크어 | da |
| 네덜란드어 | nl |
| 영어 | en |
| 핀란드어 | fi |
| 프랑스어 | fr |
| 독일어 | de |
| 헝가리어 | hu |
| 이탈리아어 | it |
| 일본어 | ja |
| 한국어 | ko |
| 노르웨이어 | nb |
| 기타/알 수 없음 | xu |
| 폴란드어 | pl |
| 포르투갈어 | pt |
| 러시아어 | ru |
| 중국어 간체 | zh-CN |
| 스페인어 | es |
| 스웨덴어 | sv |
| 중국어 번체 | zh-TW |
| 터키어 | tr |
참고: Capabilities.language 속성에는 이 목록의 값만 사용할 수 있습니다. 이러한 제한 사항으로 인해 Adobe AIR 응용 프로그램에서는 Capabilities.languages 배열의 첫 번째 요소를 사용하여 시스템의 기본 사용자 인터페이스 언어를 확인해야 합니다.
서버 문자열은 L입니다.
구현
public static function get language():String관련 API 요소
예제 ( 예제 사용 방법 )
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 | 속성 |
languages:Array [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.1 |
사용자가 운영 체제를 통해 설정한 기본 설정 사용자 인터페이스 언어에 대한 정보가 들어 있는 문자열 배열입니다. 문자열에는 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 | 속성 |
localFileReadDisable:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
사용자의 하드 디스크에 대한 읽기 액세스를 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. Adobe AIR에 있는 내용의 경우 이 속성은 응용 프로그램 보안 샌드박스가 아닌 보안 샌드박스의 내용에만 적용됩니다. 응용 프로그램 보안 샌드박스의 내용은 항상 파일 시스템에서 읽습니다. 이 속성이 true이면 Flash Player에서 Flash Player가 시작된 첫 번째 파일을 포함하여 사용자 하드 디스크의 파일을 읽을 수 없습니다. 이 속성이 true이면 응용 프로그램 보안 샌드박스 외부의 AIR 내용은 사용자 하드 디스크의 파일을 읽을 수 없습니다. 예를 들어 이 속성이 true로 설정되어 있으면 load 메서드를 통해 사용자의 하드 디스크에 있는 파일을 읽으려는 시도가 실패합니다.
이 속성이 true로 설정되면 런타임 공유 라이브러리 읽기도 차단되지만 로컬 공유 객체는 이 속성 값에 관계없이 읽을 수 있습니다.
서버 문자열은 LFD입니다.
구현
public static function get localFileReadDisable():Boolean관련 API 요소
manufacturer | 속성 |
manufacturer:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
실행 중인 버전의 Flash Player 또는 AIR 런타임 제조업체를 "Adobe OSName" 형식으로 지정합니다. OSName 값은 "Windows", "Macintosh", "Linux" 또는 기타 운영 체제 이름이 될 수 있습니다. 서버 문자열은 M입니다.
보다 구체적인 capability 속성이 존재하는 경우 운영 체제에 기반한 기능을 확인하기 위해 Capabilities.manufacturer를 사용하지 마십시오. 기능이 운영 체제에 기반하도록 하면 응용 프로그램이 모든 잠재적 대상 운영 체제를 고려하지 않는 경우 문제가 발생할 수 있으므로 좋지 않습니다. 대신, 테스트하는 기능에 해당하는 속성을 사용하십시오. 자세한 내용은 Capabilities 클래스 설명을 참조하십시오.
구현
public static function get manufacturer():StringmaxLevelIDC | 속성 |
maxLevelIDC:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
클라이언트 하드웨어가 지원하는 최상의 H.264 수준 IDC를 검색합니다. 이 수준에서 미디어를 실행하면 항상 실행되지만 최상의 수준에서 미디어를 실행하면 최상의 품질로 실행되지 않을 수도 있습니다. 이 속성은 클라이언트의 기능을 대상으로 지정하는 서버에 유용합니다. 이 속성을 사용하면 서버에서 클라이언트에 보낼 비디오의 수준을 결정할 수 있습니다.
서버 문자열은 ML입니다.
구현
public static function get maxLevelIDC():Stringos | 속성 |
os:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
현재 운영 체제를 지정합니다. os 속성은 다음 문자열을 반환할 수 있습니다.
| 운영 체제 | 값 |
|---|---|
| Windows 10 | "Windows 10" |
| Windows 8 | "Windows 8" |
| Windows 7 | "Windows 7" |
| Windows Vista | "Windows Vista" |
| Windows Server 2012 | "Windows Server 2012" |
| Windows Server 2008 R2 | "Windows Server 2008 R2" |
| Windows Server 2008 | "Windows Server 2008" |
| Windows Home Server | "Windows Home Server" |
| Windows Server 2003 R2 | "Windows Server 2003 R2" |
| Windows Server 2003 | "Windows Server 2003" |
| Windows XP 64 | "Windows Server XP 64" |
| Windows XP | "Windows XP" |
| Windows 98 | "Windows 98" |
| Windows 95 | "Windows 95" |
| Windows NT | "Windows NT" |
| Windows 2000 | "Windows 2000" |
| Windows ME | "Windows ME" |
| Windows CE | "Windows CE" |
| Windows SmartPhone | "Windows SmartPhone" |
| Windows PocketPC | "Windows PocketPC" |
| Windows CEPC | "Windows CEPC" |
| Windows Mobile | "Windows Mobile" |
| Mac OS | "Mac OS X.Y.Z"(여기서 X.Y.Z는 버전 번호(예: "Mac OS 10.5.2")) |
| Linux | "Linux"(Flash Player가 Linux 버전을 연결함, 예: "Linux 2.6.15-1.2054_FC5smp" |
| iPhone OS 4.1 | "iPhone3,1" |
서버 문자열은 OS입니다.
보다 구체적인 capability 속성이 존재하는 경우 운영 체제에 기반한 기능을 확인하기 위해 Capabilities.os를 사용하지 마십시오. 기능이 운영 체제에 기반하도록 하면 응용 프로그램이 모든 잠재적 대상 운영 체제를 고려하지 않는 경우 문제가 발생할 수 있으므로 좋지 않습니다. 대신, 테스트하는 기능에 해당하는 속성을 사용하십시오. 자세한 내용은 Capabilities 클래스 설명을 참조하십시오.
구현
public static function get os():StringpixelAspectRatio | 속성 |
playerType | 속성 |
playerType:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
런타임 환경의 유형을 지정합니다. 이 속성은 다음 값 중 하나를 가질 수 있습니다.
"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 | 속성 |
screenDPI | 속성 |
screenResolutionX | 속성 |
screenResolutionX:Number [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
스크린의 최대 수평 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다. 이 속성은 사용자의 화면 해상도로 업데이트되지 않고 대신 Flash Player 또는 Adobe AIR 응용 프로그램이 시작했을 때의 해상도만 표시합니다. 또한 이 값은 기본 스크린만 지정합니다.
구현
public static function get screenResolutionX():NumberscreenResolutionY | 속성 |
screenResolutionY:Number [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
스크린의 최대 수직 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다. 이 속성은 사용자의 화면 해상도로 업데이트되지 않고 대신 Flash Player 또는 Adobe AIR 응용 프로그램이 시작했을 때의 해상도만 표시합니다. 또한 이 값은 기본 스크린만 지정합니다.
구현
public static function get screenResolutionY():Number예제 ( 예제 사용 방법 )
import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;
var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;
addChild(screenInfoTxt);
addEventListener(MouseEvent.CLICK, getScreenNVersion);
function getScreenNVersion(e:MouseEvent):void{
screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
"flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
"flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}
serverString | 속성 |
serverString:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
각 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():Stringsupports32BitProcesses | 속성 |
supports64BitProcesses | 속성 |
touchscreenType | 속성 |
touchscreenType:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
지원되는 터치 스크린이 있는 경우 터치 스크린의 유형을 지정합니다. 값이 flash.system.TouchscreenType 클래스에 정의됩니다.
구현
public static function get touchscreenType():String관련 API 요소
예제 ( 예제 사용 방법 )
import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;
var capabilitiesTouchScreenTypeTxt:TextField = new TextField();
capabilitiesTouchScreenTypeTxt.width = 300;
capabilitiesTouchScreenTypeTxt.border = true;
addChild(capabilitiesTouchScreenTypeTxt);
addEventListener(MouseEvent.CLICK, getScreenKeyboardType);
function getScreenKeyboardType(e:MouseEvent):void{
capabilitiesTouchScreenTypeTxt.text= "flash.system.Capabilities.touchscreenType is : " + flash.system.Capabilities.touchscreenType;
}
version | 속성 |
version:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Flash Player 또는 Adobe® AIR® 플랫폼 및 버전 정보를 지정합니다. 버전 번호의 형식은 platform majorVersion,minorVersion,buildNumber,internalBuildNumber입니다. platform에 사용할 수 있는 값은 "WIN", ` "MAC", "LNX" 및 "AND"입니다. 버전 정보의 몇 가지 예는 다음과 같습니다.
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 AND 10,2,150,0 // Flash Player 10 for Android
보다 구체적인 capability 속성이 존재하는 경우 운영 체제에 기반한 기능을 확인하기 위해 Capabilities.version을 사용하지 마십시오. 기능이 운영 체제에 기반하도록 하면 응용 프로그램이 모든 잠재적 대상 운영 체제를 고려하지 않는 경우 문제가 발생할 수 있으므로 좋지 않습니다. 대신, 테스트하는 기능에 해당하는 속성을 사용하십시오. 자세한 내용은 Capabilities 클래스 설명을 참조하십시오.
서버 문자열은 V입니다.
구현
public static function get version():String예제 ( 예제 사용 방법 )
import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;
var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;
addChild(screenInfoTxt);
addEventListener(MouseEvent.CLICK, getScreenNVersion);
function getScreenNVersion(e:MouseEvent):void{
screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
"flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
"flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}
hasMultiChannelAudio | () | 메서드 |
public static function hasMultiChannelAudio(type:String):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 11, AIR 3 |
시스템에서 특정 유형의 다중 채널 오디오를 지원하는지 여부를 나타냅니다. flash.media.AudioDecoder 클래스는 가능한 유형을 열거합니다.
AIR 프로파일 지원: 다중 채널 오디오는 AIR for TV 장치에서만 지원됩니다. 다른 모든 장치에서 이 메서드는 항상 false를 반환합니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
참고: DTS 오디오 코덱 중 하나를 사용할 때는 hasMultiChannelAudio()가 true를 반환하지만 DTS 오디오가 재생되지 않는 경우가 있습니다. 예를 들어 S/PDIF 출력이 있는 Blu-ray 플레이어를 구식 앰프에 연결한 경우를 가정해 봅니다. 구식 앰프는 DTS를 지원하지 않지만 Blu-ray 플레이어에 이를 알려줄 프로토콜이 S/PDIF에 없습니다. Blu-ray 플레이어가 구식 앰프에 DTS 스트림을 보내면 사용자에게 아무 것도 들리지 않습니다. 따라서 DTS를 사용할 때는 사운드가 재생되지 않는 경우를 사용자가 알릴 수 있도록 사용자 인터페이스를 제공하는 것이 좋습니다. 이렇게 하면 응용 프로그램에서 다른 코덱으로 전환할 수 있습니다.
다음 표에서는 각 다중 채널 오디오 유형의 서버 문자열을 보여 줍니다.
| 다중 채널 오디오 유형 | 서버 문자열 |
|---|---|
AudioDecoder.DOLBY_DIGITAL | DD |
AudioDecoder.DOLBY_DIGITAL_PLUS | DDP |
AudioDecoder.DTS | DTS |
AudioDecoder.DTS_EXPRESS | DTE |
AudioDecoder.DTS_HD_HIGH_RESOLUTION_AUDIO | DTH |
AudioDecoder.DTS_HD_MASTER_AUDIO | DTM |
매개 변수
type:String — 다중 채널 오디오 유형을 나타내는 문자열 값입니다. 유효한 값은 flash.media.AudioDecoder에 정의된 상수입니다.
|
Boolean — 시스템에서 type 매개 변수로 전달된 다중 채널 오디오 유형을 지원할 경우 부울 값 true입니다. 그렇지 않으면 반환 값은 false입니다.
|
관련 API 요소
예제 ( 예제 사용 방법 )
hasMultiChannelAudio() 호출의 반환 값을 추적합니다. 반환 값은 시스템에서 Dolby Digital 다중 채널 오디오를 지원하는지 여부를 나타냅니다.
trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);
trace()에 대한 몇 번의 호출을 사용하여 값을 출력합니다.
package {
import flash.display.Sprite;
import flash.system.Capabilities;
import flash.text.TextField;
import flash.text.TextFieldAutoSize;
public class CapabilitiesExample extends Sprite {
public function CapabilitiesExample() {
showCapabilities();
}
private function showCapabilities():void {
var tf:TextField = new TextField();
tf.height = 600;
tf.width = 400;
tf.autoSize = TextFieldAutoSize.LEFT;
tf.wordWrap = true;
tf.text = "avHardwareDisable: " + Capabilities.avHardwareDisable +
"\nhasAccessibility: " + Capabilities.hasAccessibility +
"\nhasAudio: " + Capabilities.hasAudio +
"\nhasAudioEncoder: " + Capabilities.hasAudioEncoder +
"\nhasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo +
"\nhasIME: " + Capabilities.hasIME +
"\nhasMP3: " + Capabilities.hasMP3 +
"\nhasPrinting: " + Capabilities.hasPrinting +
"\nhasScreenBroadcast: " + Capabilities.hasScreenBroadcast +
"\nhasScreenPlayback: " + Capabilities.hasScreenPlayback +
"\nhasStreamingAudio: " + Capabilities.hasStreamingAudio +
"\nhasStreamingVideo: " + Capabilities.hasStreamingVideo +
"\nhasTLS: " + Capabilities.hasTLS +
"\nhasVideoEncoder: " + Capabilities.hasVideoEncoder +
"\nisDebugger: " + Capabilities.isDebugger +
"\nisEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat +
"\nlanguage: " + Capabilities.language +
"\nlocalFileReadDisable: " + Capabilities.localFileReadDisable +
"\nmanufacturer: " + Capabilities.manufacturer +
"\nmaxLevelIDC: " + Capabilities.maxLevelIDC +
"\nos: " + Capabilities.os +
"\npixelAspectRatio: " + Capabilities.pixelAspectRatio +
"\nplayerType: " + Capabilities.playerType +
"\nscreenColor: " + Capabilities.screenColor +
"\nscreenDPI: " + Capabilities.screenDPI +
"\nscreenResolutionX: " + Capabilities.screenResolutionX +
"\nscreenResolutionY: " + Capabilities.screenResolutionY +
"\nserverString: " + Capabilities.serverString +
"\ntouchscreenType: " + Capabilities.touchscreenType +
// The following capabilities are supported only when publishing for AIR.
// If you are publishing for AIR, uncomment the following lines.
//"\nlanguages: " + Capabilities.languages +
//"\ncpuArchitecture: " + Capabilities.cpuArchitecture +
//"\nsupports32BitProcesses: " + Capabilities.supports32BitProcesses +
//"\nsupports64BitProcesses: " + Capabilities.supports64BitProcesses +
"\nversion: " + Capabilities.version;
addChild(tf);
trace("avHardwareDisable: " + Capabilities.avHardwareDisable);
trace("hasAccessibility: " + Capabilities.hasAccessibility);
trace("hasAudio: " + Capabilities.hasAudio);
trace("hasAudioEncoder: " + Capabilities.hasAudioEncoder);
trace("hasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo);
trace("hasIME: " + Capabilities.hasIME);
trace("hasMP3: " + Capabilities.hasMP3);
trace("hasPrinting: " + Capabilities.hasPrinting);
trace("hasScreenBroadcast: " + Capabilities.hasScreenBroadcast);
trace("hasScreenPlayback: " + Capabilities.hasScreenPlayback);
trace("hasStreamingAudio: " + Capabilities.hasStreamingAudio);
trace("hasStreamingVideo: " + Capabilities.hasStreamingVideo);
trace("hasTLS: " + Capabilities.hasTLS);
trace("hasVideoEncoder: " + Capabilities.hasVideoEncoder);
trace("isDebugger: " + Capabilities.isDebugger);
trace("isEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat);
trace("language: " + Capabilities.language);
trace("localFileReadDisable: " + Capabilities.localFileReadDisable);
trace("manufacturer: " + Capabilities.manufacturer);
trace("maxLevelIDC: " + Capabilities.maxLevelIDC);
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("touchscreenType: " + Capabilities.touchscreenType);
// The following capabilities are supported only when publishing for AIR.
// If you are publishing for AIR, uncomment the following lines.
//trace("cpuArchitecture: " + Capabilities.cpuArchitecture);
//trace("languages: " + Capabilities.languages);
//trace("supports32BitProcesses: " + Capabilities.supports32BitProcesses);
//trace("supports64BitProcesses: " + Capabilities.supports64BitProcesses);
trace("version: " + Capabilities.version);
}
}
}
Tue Jun 12 2018, 03:17 PM Z