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 エレメント

システムが、Web カメラからの入力などのビデオストリームをエンコードできるか（true）、またはできないか（false）を指定します。サーバーストリングは VE です。

システムがデバッグ用の特別なバージョンか（true）、または正式にリリースされたバージョンか（false）を指定します。 サーバーストリングは DEB です。このプロパティは、Flash Player のデバッグ版または AIR Debug Launcher（ADL）で実行する場合、true に設定されます。

Flash ランタイムが、Acrobat 9.0 以降で開くことができる PDF ファイルに埋め込まれているか（true）、またはそうでないか（false）を指定します。

コンテンツが実行されているシステムの言語コードを指定します。言語は、ISO 639-1 で規定された小文字 2 文字の言語コードで指定されます。中国語については、簡体字と繁体字を識別するために、ISO 3166 で規定された大文字 2 文字の国コードが追加されます。言語コードは、言語の英語名に基づきます。例えば、hu はハンガリー語を示します。

英語のシステムでは、このプロパティは言語コード（en）のみを返し、国コードは返しません。Microsoft Windows システムでは、このプロパティはユーザーインターフェイス（UI）言語を返します。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" を返します。

返される配列の最初のエントリには一般に、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 の場合は、読み取りに失敗します。

このプロパティが true に設定されている場合、ランタイム共有ライブラリの読み取りも失敗しますが、ローカル共有オブジェクトはこのプロパティの値に関係なく読み取ることができます。

サーバーストリングは LFD です。

関連する API エレメント

Flash Player または AIR ランタイムの実行バージョンの製造会社を "Adobe OSName" の形式で指定します。OSName の値は、"Windows"、"Macintosh"、"Linux" または別のオペレーティングシステム名になります。サーバーストリングは M です。

より具体的な機能のプロパティが存在する場合に、Capabilities.manufacturer を使用して、オペレーティングシステムに基づく機能を判断しないでください。機能をオペレーティングシステムに依存することは、アプリケーションが潜在的なすべてのターゲットオペレーティングシステムを考慮していない場合に問題が発生する可能性があるので、適切ではありません。代わりに、テストしている機能に対応するプロパティを使用します。詳細については、Capabilities クラスの説明を参照してください。

クライアントハードウェアがサポートする H.264 の最高レベルの IDC を取得します。このレベルでのメディア実行は保証されますが、最高レベルでのメディア実行は最高品質では実行されない場合があります。このプロパティは、クライアントの機能をターゲットとするサーバーに役立ちます。このプロパティを使用すると、サーバーはクライアントに送るビデオのレベルを決定できます。

サーバーストリングは ML です。

現在のオペレーティングシステムを指定します。os プロパティは、次のストリングを返すことができます。

サーバーストリングは OS です。

より具体的な機能のプロパティが存在する場合に、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 です。

画面の 1 インチあたりのドット数（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 bit プロセスの実行がサポートされているかどうかを指定します。サーバーストリングは PR32 です。

64 bit プロセスの実行がサポートされているかどうかを指定します。サーバーストリングは 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
	 

より具体的な機能のプロパティが存在する場合に、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 出力を備えたブルーレイプレーヤーを古いアンプに接続している場合について考えてみます。古いアンプは DTS に対応していませんが、S/PDIF にはブルーレイプレーヤーに通知するプロトコルがありません。ブルーレイプレーヤーから古いアンプに DTS ストリームが送信されても、ユーザーには何も聞こえません。したがって、ベストプラクティスとして、DTS を使用するときは、サウンドが再生されていないときにユーザーが指摘できるように、ユーザーインターフェイスを提供してください。そうすれば、アプリケーションは別のコーデックに復帰できます。

次の表に、各マルチチャンネルオーディオタイプに対するサーバーストリングを示します。

パラメーター

関連する API エレメント

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