| Player 버전 : | Flash Player 9 |
Capabilities 클래스에서는 SWF 파일을 호스팅하는 시스템 및 플레이어를 설명하는 속성을 제공합니다. 예를 들어 휴대폰 화면은 흑백 100제곱 픽셀일 수 있고 PC 화면은 컬러 1000제곱 픽셀일 수 있습니다. Capabilities 객체를 통해 사용자의 장치 유형을 확인하면 최대한 많은 사용자에게 적절한 콘텐츠를 제공할 수 있습니다. 장치의 성능을 파악하면 서버에서 적절한 SWF 파일을 보내도록 지시하거나 SWF 파일에서 프리젠테이션을 변경하도록 지시할 수 있습니다.
GET 또는 POST HTTP 메서드를 사용하여 Capabilities.serverString 속성에 URL 인코딩 문자열로 저장된 플레이어의 성능 정보를 보낼 수 있습니다. 다음 예제에서는 IME가 설치된 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
다음 표에서는 사용할 수 있는 ActionScript 속성 및 해당 서버 문자열을 보여 줍니다.
| ActionScript 속성 | 서버 문자열 |
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 |
os | OS |
pixelAspectRatio | AR |
playerType | PT |
screenColor | COL |
screenDPI | DP |
screenResolutionX | R |
screenResolutionY | R |
version | V |
Capabilities 클래스의 모든 속성은 읽기 전용입니다.
예제를 통해 확인하십시오.
avHardwareDisable:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
사용자의 카메라와 마이크에 대한 액세스가 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. 서버 문자열은 AVD입니다.
구현
public static function get avHardwareDisable():Boolean
참고 사항
hasAccessibility:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 환경에서 액세스 가능성 도구와의 통신을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 ACC입니다.
구현
public static function get hasAccessibility():Boolean
참고 사항
hasAudio:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 시스템에 오디오 기능이 있는지 여부를 지정합니다. 이 속성은 항상 true입니다. 서버 문자열은 A입니다.
구현
public static function get hasAudio():Boolean
hasAudioEncoder:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어에서 마이크 입력 등의 오디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false)를 지정합니다. 서버 문자열은 AE입니다.
구현
public static function get hasAudioEncoder():Boolean
hasEmbeddedVideo:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 시스템에서 포함된 비디오를 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 EV입니다.
구현
public static function get hasEmbeddedVideo():Boolean
hasIME:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 시스템에 IME가 설치되어 있는지(true) 또는 설치되어 있지 않은지(false)를 지정합니다. 서버 문자열은 IME입니다.
구현
public static function get hasIME():Boolean
참고 사항
hasMP3:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 시스템에 MP3 디코더가 있는지(true) 또는 없는지(false)를 지정합니다. 서버 문자열은 MP3입니다.
구현
public static function get hasMP3():Boolean
참고 사항
hasPrinting:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 시스템에서 인쇄를 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 PR입니다.
구현
public static function get hasPrinting():Boolean
hasScreenBroadcast:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 개발을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 SB입니다.
구현
public static function get hasScreenBroadcast():Boolean
hasScreenPlayback:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 재생을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 SP입니다.
구현
public static function get hasScreenPlayback():Boolean
hasStreamingAudio:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어에서 스트리밍 오디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false)를 지정합니다. 서버 문자열은 SA입니다.
구현
public static function get hasStreamingAudio():Boolean
hasStreamingVideo:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어에서 스트리밍 비디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false)를 지정합니다. 서버 문자열은 SV입니다.
구현
public static function get hasStreamingVideo():Boolean
hasTLS:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 실행되는 시스템에서 NetConnection을 통한 네이티브 SSL 소켓을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 TLS입니다.
구현
public static function get hasTLS():Boolean
참고 사항
hasVideoEncoder:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어에서 웹 카메라 입력 등의 비디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false)를 지정합니다. 서버 문자열은 VE입니다.
구현
public static function get hasVideoEncoder():Boolean
isDebugger:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
플레이어가 특수 디버깅 버전인지(true) 또는 정식으로 출시된 버전인지(false)를 지정합니다. 서버 문자열은 DEB입니다.
구현
public static function get isDebugger():Boolean
language:String [read-only]
| Player 버전 : | 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 |
서버 문자열은 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);
}
}
}
localFileReadDisable:Boolean [read-only]
| Player 버전 : | Flash Player 9 |
사용자의 하드 디스크에 대한 읽기 액세스를 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. 이 속성이 true이면 Flash Player에서 Flash Player가 시작된 첫 번째 SWF 파일을 포함하여 사용자 하드 디스크의 파일을 읽을 수 없습니다. 예를 들어 이 속성이 true로 설정되어 있으면 load 메서드를 통해 사용자의 하드 디스크에 있는 파일을 읽으려는 시도가 실패합니다.
이 속성이 true로 설정되면 런타임 공유 라이브러리 읽기도 차단되지만 로컬 공유 객체는 이 속성 값에 관계없이 읽을 수 있습니다. 서버 문자열은 LFD입니다.
구현
public static function get localFileReadDisable():Boolean
참고 사항
manufacturer:String [read-only]
| Player 버전 : | Flash Player 9 |
Flash Player의 제조자를 "Adobe OSName" 형식으로 지정합니다. OSName 값은 "Windows", "Macintosh", "Linux" 또는 기타 운영 체제 이름이 될 수 있습니다. 서버 문자열은 M입니다.
구현
public static function get manufacturer():String
os:String [read-only]
| Player 버전 : | Flash Player 9 |
현재 운영 체제를 지정합니다. os 속성은 "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE"(데스크탑 버전이 아니라 Flash Player SDK에서만 사용 가능), "Linux" 및 "MacOS" 문자열을 반환할 수 있습니다. 서버 문자열은 OS입니다.
구현
public static function get os():String
pixelAspectRatio:Number [read-only]
| Player 버전 : | Flash Player 9 |
스크린의 픽셀 종횡비를 지정합니다. 서버 문자열은 AR입니다.
구현
public static function get pixelAspectRatio():Number
playerType:String [read-only]
| Player 버전 : | Flash Player 9 |
플레이어 유형을 지정합니다. 이 속성은 다음 값 중 하나를 가질 수 있습니다.
"StandAlone": 독립 실행형 Flash Player의 경우
"External": 외부 Flash Player용 또는 테스트 모드의 경우
"PlugIn": Flash Player 브라우저 플러그인의 경우
"ActiveX": Microsoft Internet Explorer에서 사용하는 Flash Player ActiveX 컨트롤의 경우
서버 문자열은 PT입니다.
구현
public static function get playerType():String
screenColor:String [read-only]
| Player 버전 : | Flash Player 9 |
스크린 색상을 지정합니다. 이 속성은 "color", "gray"(회색조) 또는 "bw"(흑백) 값을 가질 수 있습니다. 서버 문자열은 COL입니다.
구현
public static function get screenColor():String
screenDPI:Number [read-only]
| Player 버전 : | Flash Player 9 |
스크린의 dpi(인치당 도트 수) 해상도를 픽셀 단위로 지정합니다. 서버 문자열은 DP입니다.
구현
public static function get screenDPI():Number
screenResolutionX:Number [read-only]
| Player 버전 : | Flash Player 9 |
스크린의 최대 수평 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다.
구현
public static function get screenResolutionX():Number
참고 사항
screenResolutionY:Number [read-only]
| Player 버전 : | Flash Player 9 |
스크린의 최대 수직 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다.
구현
public static function get screenResolutionY():Number
참고 사항
serverString:String [read-only]
| Player 버전 : | 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 [read-only]
| Player 버전 : | Flash Player 9 |
Flash Player 플랫폼 및 버전 정보를 지정합니다. 버전 번호의 형식은 platform majorVersion, minorVersion, buildNumber, internalBuildNumber입니다. platform에 사용할 수 있는 값은 "WIN", "MAC" 및 "UNIX"입니다. 버전 정보의 몇 가지 예는 다음과 같습니다.
WIN 9,0,0,0 // Windows용 Flash Player 9
MAC 7,0,25,0 // Macintosh용 Flash Player 7
UNIX 5,0,55,0 // UNIX용 Flash Player 5
서버 문자열은 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-2007 Adobe Systems Incorporated. All rights reserved.
Tue Oct 16 2007, 12:25 AM GMT-07:00
현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/system/Capabilities.html