패키지flash.system
클래스public final class Capabilities
상속Capabilities Inheritance Object

언어 버전 : ActionScript 3.0
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 속성서버 문자열
avHardwareDisableAVD
hasAccessibilityACC
hasAudioA
hasAudioEncoderAE
hasEmbeddedVideoEV
hasIMEIME
hasMP3MP3
hasPrintingPR
hasScreenBroadcastSB
hasScreenPlaybackSP
hasStreamingAudioSA
hasStreamingVideoSV
hasTLSTLS
hasVideoEncoderVE
isDebuggerDEB
languageL
localFileReadDisableLFD
manufacturerM
osOS
pixelAspectRatioAR
playerTypePT
screenColorCOL
screenDPIDP
screenResolutionXR
screenResolutionYR
versionV

Capabilities 클래스의 모든 속성은 읽기 전용입니다.

예제를 통해 확인하십시오.

참고 사항

Capabilities 클래스 사용


Public 속성
 속성다음에 의해 정의됨
  avHardwareDisable : Boolean
[static] [read-only] 사용자의 카메라와 마이크에 대한 액세스가 금지되었는지(true) 또는 허용되었는지(false) 여부를 지정합니다.
Capabilities
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  hasAccessibility : Boolean
[static] [read-only] 플레이어가 실행되는 환경에서 액세스 가능성 도구와의 통신을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다.
Capabilities
  hasAudio : Boolean
[static] [read-only] 플레이어가 실행되는 시스템에 오디오 기능이 있는지 여부를 지정합니다.
Capabilities
  hasAudioEncoder : Boolean
[static] [read-only] 플레이어에서 마이크 입력 등의 오디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false)를 지정합니다.
Capabilities
  hasEmbeddedVideo : Boolean
[static] [read-only] 플레이어가 실행되는 시스템에서 포함된 비디오를 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다.
Capabilities
  hasIME : Boolean
[static] [read-only] 플레이어가 실행되는 시스템에 IME가 설치되어 있는지(true) 또는 설치되어 있지 않은지(false)를 지정합니다.
Capabilities
  hasMP3 : Boolean
[static] [read-only] 플레이어가 실행되는 시스템에 MP3 디코더가 있는지(true) 또는 없는지(false)를 지정합니다.
Capabilities
  hasPrinting : Boolean
[static] [read-only] 플레이어가 실행되는 시스템에서 인쇄를 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다.
Capabilities
  hasScreenBroadcast : Boolean
[static] [read-only] 플레이어에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 개발을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다.
Capabilities
  hasScreenPlayback : Boolean
[static] [read-only] 플레이어에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 재생을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다.
Capabilities
  hasStreamingAudio : Boolean
[static] [read-only] 플레이어에서 스트리밍 오디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false)를 지정합니다.
Capabilities
  hasStreamingVideo : Boolean
[static] [read-only] 플레이어에서 스트리밍 비디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false)를 지정합니다.
Capabilities
  hasTLS : Boolean
[static] [read-only] 플레이어가 실행되는 시스템에서 NetConnection을 통한 네이티브 SSL 소켓을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다.
Capabilities
  hasVideoEncoder : Boolean
[static] [read-only] 플레이어에서 웹 카메라 입력 등의 비디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false)를 지정합니다.
Capabilities
  isDebugger : Boolean
[static] [read-only] 플레이어가 특수 디버깅 버전인지(true) 또는 정식으로 출시된 버전인지(false)를 지정합니다.
Capabilities
  language : String
[static] [read-only] 플레이어가 실행되는 시스템의 언어 코드를 지정합니다.
Capabilities
  localFileReadDisable : Boolean
[static] [read-only] 사용자의 하드 디스크에 대한 읽기 액세스가 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다.
Capabilities
  manufacturer : String
[static] [read-only] Flash Player의 제조자를 "Adobe OSName" 형식으로 지정합니다.
Capabilities
  os : String
[static] [read-only] 현재 운영 체제를 지정합니다.
Capabilities
  pixelAspectRatio : Number
[static] [read-only] 스크린의 픽셀 종횡비를 지정합니다.
Capabilities
  playerType : String
[static] [read-only] 플레이어 유형을 지정합니다.
Capabilities
 Inheritedprototype : Object
[static] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  screenColor : String
[static] [read-only] 스크린 색상을 지정합니다.
Capabilities
  screenDPI : Number
[static] [read-only] 스크린의 dpi(인치당 도트 수) 해상도를 픽셀 단위로 지정합니다.
Capabilities
  screenResolutionX : Number
[static] [read-only] 스크린의 최대 수평 해상도를 지정합니다.
Capabilities
  screenResolutionY : Number
[static] [read-only] 스크린의 최대 수직 해상도를 지정합니다.
Capabilities
  serverString : String
[static] [read-only] 각 Capabilities 속성의 값을 지정하는 URL 인코딩 문자열입니다.
Capabilities
  version : String
[static] [read-only] Flash Player 플랫폼 및 버전 정보를 지정합니다.
Capabilities
Public 메서드
 메서드다음에 의해 정의됨
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 정보
avHardwareDisable속성
avHardwareDisable:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

사용자의 카메라와 마이크에 대한 액세스가 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. 서버 문자열은 AVD입니다.


구현
    public static function get avHardwareDisable():Boolean

참고 사항

hasAccessibility속성 
hasAccessibility:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 환경에서 액세스 가능성 도구와의 통신을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 ACC입니다.


구현
    public static function get hasAccessibility():Boolean

참고 사항

hasAudio속성 
hasAudio:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 시스템에 오디오 기능이 있는지 여부를 지정합니다. 이 속성은 항상 true입니다. 서버 문자열은 A입니다.


구현
    public static function get hasAudio():Boolean
hasAudioEncoder속성 
hasAudioEncoder:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어에서 마이크 입력 등의 오디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false)를 지정합니다. 서버 문자열은 AE입니다.


구현
    public static function get hasAudioEncoder():Boolean
hasEmbeddedVideo속성 
hasEmbeddedVideo:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 시스템에서 포함된 비디오를 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 EV입니다.


구현
    public static function get hasEmbeddedVideo():Boolean
hasIME속성 
hasIME:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 시스템에 IME가 설치되어 있는지(true) 또는 설치되어 있지 않은지(false)를 지정합니다. 서버 문자열은 IME입니다.


구현
    public static function get hasIME():Boolean

참고 사항

hasMP3속성 
hasMP3:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 시스템에 MP3 디코더가 있는지(true) 또는 없는지(false)를 지정합니다. 서버 문자열은 MP3입니다.


구현
    public static function get hasMP3():Boolean

참고 사항

hasPrinting속성 
hasPrinting:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 시스템에서 인쇄를 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 PR입니다.


구현
    public static function get hasPrinting():Boolean
hasScreenBroadcast속성 
hasScreenBroadcast:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 개발을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 SB입니다.


구현
    public static function get hasScreenBroadcast():Boolean
hasScreenPlayback속성 
hasScreenPlayback:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어에서 Flash Media Server를 통해 실행되는 스크린 브로드캐스트 응용 프로그램 재생을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 SP입니다.


구현
    public static function get hasScreenPlayback():Boolean
hasStreamingAudio속성 
hasStreamingAudio:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어에서 스트리밍 오디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false)를 지정합니다. 서버 문자열은 SA입니다.


구현
    public static function get hasStreamingAudio():Boolean
hasStreamingVideo속성 
hasStreamingVideo:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어에서 스트리밍 비디오를 재생할 수 있는지(true) 또는 재생할 수 없는지(false)를 지정합니다. 서버 문자열은 SV입니다.


구현
    public static function get hasStreamingVideo():Boolean
hasTLS속성 
hasTLS:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 실행되는 시스템에서 NetConnection을 통한 네이티브 SSL 소켓을 지원하는지(true) 또는 지원하지 않는지(false)를 지정합니다. 서버 문자열은 TLS입니다.


구현
    public static function get hasTLS():Boolean

참고 사항

hasVideoEncoder속성 
hasVideoEncoder:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어에서 웹 카메라 입력 등의 비디오 스트림을 인코딩할 수 있는지(true) 또는 인코딩할 수 없는지(false)를 지정합니다. 서버 문자열은 VE입니다.


구현
    public static function get hasVideoEncoder():Boolean
isDebugger속성 
isDebugger:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어가 특수 디버깅 버전인지(true) 또는 정식으로 출시된 버전인지(false)를 지정합니다. 서버 문자열은 DEB입니다.


구현
    public static function get isDebugger():Boolean
language속성 
language:String  [read-only]

언어 버전 : ActionScript 3.0
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속성 
localFileReadDisable:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

사용자의 하드 디스크에 대한 읽기 액세스를 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. 이 속성이 true이면 Flash Player에서 Flash Player가 시작된 첫 번째 SWF 파일을 포함하여 사용자 하드 디스크의 파일을 읽을 수 없습니다. 예를 들어 이 속성이 true로 설정되어 있으면 load 메서드를 통해 사용자의 하드 디스크에 있는 파일을 읽으려는 시도가 실패합니다.

이 속성이 true로 설정되면 런타임 공유 라이브러리 읽기도 차단되지만 로컬 공유 객체는 이 속성 값에 관계없이 읽을 수 있습니다. 서버 문자열은 LFD입니다.


구현
    public static function get localFileReadDisable():Boolean

참고 사항

manufacturer속성 
manufacturer:String  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

Flash Player의 제조자를 "Adobe OSName" 형식으로 지정합니다. OSName 값은 "Windows", "Macintosh", "Linux" 또는 기타 운영 체제 이름이 될 수 있습니다. 서버 문자열은 M입니다.


구현
    public static function get manufacturer():String
os속성 
os:String  [read-only]

언어 버전 : ActionScript 3.0
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속성 
pixelAspectRatio:Number  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

스크린의 픽셀 종횡비를 지정합니다. 서버 문자열은 AR입니다.


구현
    public static function get pixelAspectRatio():Number
playerType속성 
playerType:String  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

플레이어 유형을 지정합니다. 이 속성은 다음 값 중 하나를 가질 수 있습니다.

서버 문자열은 PT입니다.


구현
    public static function get playerType():String
screenColor속성 
screenColor:String  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

스크린 색상을 지정합니다. 이 속성은 "color", "gray"(회색조) 또는 "bw"(흑백) 값을 가질 수 있습니다. 서버 문자열은 COL입니다.


구현
    public static function get screenColor():String
screenDPI속성 
screenDPI:Number  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

스크린의 dpi(인치당 도트 수) 해상도를 픽셀 단위로 지정합니다. 서버 문자열은 DP입니다.


구현
    public static function get screenDPI():Number
screenResolutionX속성 
screenResolutionX:Number  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

스크린의 최대 수평 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다.


구현
    public static function get screenResolutionX():Number

참고 사항

screenResolutionY속성 
screenResolutionY:Number  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

스크린의 최대 수직 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다.


구현
    public static function get screenResolutionY():Number

참고 사항

serverString속성 
serverString:String  [read-only]

언어 버전 : ActionScript 3.0
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속성 
version:String  [read-only]

언어 버전 : ActionScript 3.0
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

참고 사항

예제 예제 사용 방법
CapabilitiesExample.as

다음 예제에서는 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);
        }
    }
}




 

이 페이지에 의견 추가되면 전자 메일 알림 받기 | 의견 보고서

현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/system/Capabilities.html