Capabilities  - AS3

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

Adobe AIR™에 있는 내용의 경우 이 속성은 응용 프로그램 보안 샌드박스가 아닌 보안 샌드박스의 내용에만 적용됩니다. 응용 프로그램 보안 샌드박스의 내용은 항상 사용자의 카메라 및 마이크에 액세스할 수 있습니다.

관련 API 요소

현재 CPU 아키텍처를 지정합니다. cpuArchitecture 속성은 "PowerPC", "x86", "SPARC" 및 "ARM" 문자열을 반환할 수 있습니다. 서버 문자열은 ARCH입니다.

시스템에서 액세스 가능성 도구와의 통신을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 ACC입니다.

관련 API 요소

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

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

시스템에서 포함된 비디오를 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 EV입니다.

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

관련 API 요소

시스템에 MP3 디코더가 있는지(true) 또는 없는지(false) 여부를 지정합니다. 서버 문자열은 MP3입니다.

시스템에서 인쇄를 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 PR입니다.

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

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

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

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

시스템에서 NetConnection을 통한 기본 SSL 소켓을 지원하는지(true) 또는 지원하지 않는지(false) 여부를 지정합니다. 서버 문자열은 TLS입니다.

관련 API 요소

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

시스템이 특수 디버깅 버전인지(true) 또는 정식으로 출시된 버전인지(false) 여부를 지정합니다. 서버 문자열은 DEB입니다. Flash Player의 디버그 버전 또는 ADL(AIR Debug Launcher)에서 실행할 경우 이 속성은 true로 설정됩니다.

Flash 런타임이 Acrobat 9.0 이상에서 열리는 PDF 파일에 포함되어 있는지(true) 아니면 포함되어 있지 않은지(false)를 지정합니다.

내용이 실행되는 시스템의 언어 코드를 지정합니다. 언어는 ISO 639-1에 소문자로 지정된 두 글자 언어 코드로 지정됩니다. 중국어의 경우 ISO 3166의 대문자로 된 두 글자 국가 코드가 추가되어 중국어 간체와 번체가 구별됩니다. 언어 코드는 해당 언어의 영어 이름에 기초합니다. 예를 들어 헝가리어는 hu로 지정됩니다.

영어 시스템에서 이 속성은 국가 코드가 아닌 언어 코드(en)만 반환합니다. Microsoft Windows 시스템에서 이 속성은 모든 메뉴, 대화 상자, 오류 메시지 및 도움말 파일에 사용되는 언어를 참조하는 UI(사용자 인터페이스) 언어를 반환합니다. 다음 표에는 가능한 값이 나열되어 있습니다.

참고: Capabilities.language 속성에는 이 목록의 값만 사용할 수 있습니다. 이러한 제한 사항으로 인해 Adobe AIR 응용 프로그램에서는 Capabilities.languages 배열의 첫 번째 요소를 사용하여 시스템의 기본 사용자 인터페이스 언어를 확인해야 합니다.

서버 문자열은 L입니다.

관련 API 요소

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);
        }
    }
}

사용자가 운영 체제를 통해 설정한 기본 설정 사용자 인터페이스 언어에 대한 정보가 들어 있는 문자열 배열입니다. 문자열에는 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입니다.

사용자의 하드 디스크에 대한 읽기 액세스를 금지되었는지(true) 또는 허용되었는지(false)를 지정합니다. Adobe AIR에 있는 내용의 경우 이 속성은 응용 프로그램 보안 샌드박스가 아닌 보안 샌드박스의 내용에만 적용됩니다. 응용 프로그램 보안 샌드박스의 내용은 항상 파일 시스템에서 읽습니다. 이 속성이 true이면 Flash Player에서 Flash Player가 시작된 첫 번째 파일을 포함하여 사용자 하드 디스크의 파일을 읽을 수 없습니다. 이 속성이 true이면 응용 프로그램 보안 샌드박스 외부의 AIR 내용은 사용자 하드 디스크의 파일을 읽을 수 없습니다. 예를 들어 이 속성이 true로 설정되어 있으면 load 메서드를 통해 사용자의 하드 디스크에 있는 파일을 읽으려는 시도가 실패합니다.

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

서버 문자열은 LFD입니다.

관련 API 요소

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

보다 구체적인 capability 속성이 존재하는 경우 운영 체제에 기반한 기능을 확인하기 위해 Capabilities.manufacturer를 사용하지 마십시오. 기능이 운영 체제에 기반하도록 하면 응용 프로그램이 모든 잠재적 대상 운영 체제를 고려하지 않는 경우 문제가 발생할 수 있으므로 좋지 않습니다. 대신, 테스트하는 기능에 해당하는 속성을 사용하십시오. 자세한 내용은 Capabilities 클래스 설명을 참조하십시오.

클라이언트 하드웨어가 지원하는 최상의 H.264 수준 IDC를 검색합니다. 이 수준에서 미디어를 실행하면 항상 실행되지만 최상의 수준에서 미디어를 실행하면 최상의 품질로 실행되지 않을 수도 있습니다. 이 속성은 클라이언트의 기능을 대상으로 지정하는 서버에 유용합니다. 이 속성을 사용하면 서버에서 클라이언트에 보낼 비디오의 수준을 결정할 수 있습니다.

서버 문자열은 ML입니다.

현재 운영 체제를 지정합니다. os 속성은 다음 문자열을 반환할 수 있습니다.

서버 문자열은 OS입니다.

보다 구체적인 capability 속성이 존재하는 경우 운영 체제에 기반한 기능을 확인하기 위해 Capabilities.os를 사용하지 마십시오. 기능이 운영 체제에 기반하도록 하면 응용 프로그램이 모든 잠재적 대상 운영 체제를 고려하지 않는 경우 문제가 발생할 수 있으므로 좋지 않습니다. 대신, 테스트하는 기능에 해당하는 속성을 사용하십시오. 자세한 내용은 Capabilities 클래스 설명을 참조하십시오.

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

런타임 환경의 유형을 지정합니다. 이 속성은 다음 값 중 하나를 가질 수 있습니다.

• "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입니다.

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

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

스크린의 최대 수평 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다. 이 속성은 사용자의 화면 해상도로 업데이트되지 않고 대신 Flash Player 또는 Adobe AIR 응용 프로그램이 시작했을 때의 해상도만 표시합니다. 또한 이 값은 기본 스크린만 지정합니다.

스크린의 최대 수직 해상도를 지정합니다. 서버 문자열은 화면의 폭과 높이를 모두 반환하는 R입니다. 이 속성은 사용자의 화면 해상도로 업데이트되지 않고 대신 Flash Player 또는 Adobe AIR 응용 프로그램이 시작했을 때의 해상도만 표시합니다. 또한 이 값은 기본 스크린만 지정합니다.

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;
}

각 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

시스템이 32비트 프로세스 실행을 지원하는지 여부를 지정합니다. 서버 문자열은 PR32입니다.

시스템이 64비트 프로세스 실행을 지원하는지 여부를 지정합니다. 서버 문자열은 PR64입니다.

지원되는 터치 스크린이 있는 경우 터치 스크린의 유형을 지정합니다. 값이 flash.system.TouchscreenType 클래스에 정의됩니다.

관련 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;
}

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입니다.

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;
}

시스템에서 특정 유형의 다중 채널 오디오를 지원하는지 여부를 나타냅니다. 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를 사용할 때는 사운드가 재생되지 않는 경우를 사용자가 알릴 수 있도록 사용자 인터페이스를 제공하는 것이 좋습니다. 이렇게 하면 응용 프로그램에서 다른 코덱으로 전환할 수 있습니다.

다음 표에서는 각 다중 채널 오디오 유형의 서버 문자열을 보여 줍니다.

매개 변수

관련 API 요소

    trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);