パッケージflash.system
クラスpublic final class Capabilities
継承Capabilities Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

Capabilities クラスでは、SWF ファイルをホスティングするシステムとプレーヤーを記述するプロパティが提供されています。例えば、携帯電話の画面は 100 × 100 ピクセル、モノクロで、PC の画面は 1000 × 1000 ピクセル、カラーである場合があります。Capabilities オブジェクトを使用してユーザーが使用しているデバイスのタイプを確認することによって、できるだけ多数のユーザーに対して適切なコンテンツを提供できます。デバイスの機能がわかると、適切な SWF ファイルを送るようにサーバーに指示したり、表示形式を変更するように SWF ファイルに指示したりすることができます。

ただし、Adobe AIR の一部の機能は、Capabilities クラスのプロパティとしてリストに示されていません。これらは他のクラスのプロパティです。

プロパティ説明
NativeApplication.supportsDockIcon オペレーティングシステムがシステムドックアイコンをサポートするかどうか。
NativeApplication.supportsMenu オペレーティングシステムがグローバルアプリケーションメニューバーをサポートするかどうか。
NativeApplication.supportsSystemTrayIcon オペレーティングシステムがシステムトレイアイコンをサポートするかどうか。
NativeWindow.supportsMenu オペレーティングシステムがウィンドウメニューをサポートするかどうか。
NativeWindow.supportsTransparency オペレーティングシステムが透明なウィンドウをサポートするかどうか。

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

機能情報 (Capabilities.serverString プロパティに URL エンコードされたストリングとして格納されている) を、GET または POST HTTP メソッドを使用して送信できます。次に、MP3 をサポートし、解像度が 1600 × 1200 ピクセルで、Windows XP を実行しており、IME がインストールされているコンピュータに対するサーバーストリングの例を示します。

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

次の表に、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

Capabilities クラスのプロパティは、すべて読み取り専用です。

例を表示

関連項目

Determining Flash Player version in Flex
Using the Capabilities class


パブリックプロパティ
 プロパティ定義元
  avHardwareDisable : Boolean
[静的] [読み取り専用] ユーザーのカメラとマイクへのアクセスが管理上禁止されているか (true)、または許可されているか (false) を指定します。
Capabilities
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  AIR-only 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
[静的] [読み取り専用] システムが、Web カメラからの入力などのビデオストリームをエンコードできるか (true)、またはできないか (false) を指定します。
Capabilities
  isDebugger : Boolean
[静的] [読み取り専用] システムがデバッグ用の特別なバージョンか(true)、または正式にリリースされたバージョンか(false)を指定します。
Capabilities
  isEmbeddedInAcrobat : Boolean
[静的] [読み取り専用] PDF ファイルに埋め込まれているプレーヤーが Acrobat 9.0 以降で開くか (true)、またはそうではないか (false) を指定します。
Capabilities
  language : String
[静的] [読み取り専用] コンテンツが実行されているシステムの言語コードを指定します。
Capabilities
  AIR-only 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
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  screenColor : String
[静的] [読み取り専用] 画面の色を指定します。
Capabilities
  screenDPI : Number
[静的] [読み取り専用] 画面の 1 インチあたりのドット数 (dpi) 解像度をピクセル単位で指定します。
Capabilities
  screenResolutionX : Number
[静的] [読み取り専用] 画面の最大水平解像度を指定します。
Capabilities
  screenResolutionY : Number
[静的] [読み取り専用] 画面の最大垂直解像度を指定します。
Capabilities
  serverString : String
[静的] [読み取り専用] それぞれの Capabilities プロパティの値を指定する URL エンコードストリングです。
Capabilities
  version : String
[静的] [読み取り専用] Flash Player または Adobe® AIR のプラットフォームとバージョン情報を指定します。
Capabilities
パブリックメソッド
 メソッド定義元
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
avHardwareDisableプロパティ
avHardwareDisable:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

ユーザーのカメラとマイクへのアクセスが管理上禁止されているか (true)、または許可されているか (false) を指定します。サーバーストリングは AVD です。

Adobe AIR™ のコンテンツでは、このプロパティはアプリケーションセキュリティサンドボックス以外のセキュリティサンドボックス内のコンテンツにのみ適用されます。アプリケーションセキュリティサンドボックス内のコンテンツは常にユーザーのカメラとマイクにアクセスできます。



実装
    public static function get avHardwareDisable():Boolean

関連項目

AIR-only cpuArchitectureプロパティ 
cpuArchitecture:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5.1

コンピュータの現在の CPU アーキテクチャを指定します。cpuArchitecture プロパティは、PowerPCx86SPARC、および ARM のいずれかのストリングを返します。サーバーストリングは ARCH です。



実装
    public static function get cpuArchitecture():String
hasAccessibilityプロパティ 
hasAccessibility:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムがアクセシビリティ補助との通信をサポートしているか (true)、またはサポートしていないか (false) を指定します。サーバーストリングは ACC です。



実装
    public static function get hasAccessibility():Boolean

関連項目

hasAudioプロパティ 
hasAudio:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムにオーディオ機能があるかどうかを指定します。このプロパティは常に true です。サーバーストリングは A です。



実装
    public static function get hasAudio():Boolean
hasAudioEncoderプロパティ 
hasAudioEncoder:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムが、マイクからの入力などのオーディオストリームをエンコードできるか (true)、またはできないか (false) を指定します。サーバーストリングは AE です。



実装
    public static function get hasAudioEncoder():Boolean
hasEmbeddedVideoプロパティ 
hasEmbeddedVideo:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムが埋め込みビデオをサポートしているか (true)、またはサポートしていないか (false) を指定します。サーバーストリングは EV です。



実装
    public static function get hasEmbeddedVideo():Boolean
hasIMEプロパティ 
hasIME:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムに IME がインストールされているか (true)、またはインストールされていないか (false) を指定します。サーバーストリングは IME です。



実装
    public static function get hasIME():Boolean

関連項目

hasMP3プロパティ 
hasMP3:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムに MP3 デコーダが存在するか (true)、または存在しないか (false) を指定します。サーバーストリングは MP3 です。



実装
    public static function get hasMP3():Boolean

関連項目

hasPrintingプロパティ 
hasPrinting:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムが印刷をサポートしているか (true)、またはサポートしていないか (false) を指定します。サーバーストリングは PR です。



実装
    public static function get hasPrinting():Boolean
hasScreenBroadcastプロパティ 
hasScreenBroadcast:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

Flash Media Server を通して実行されるスクリーンブロードキャストアプリケーションの開発がシステムでサポートされているか (true)、またはサポートされていないか (false) を指定します。サーバーストリングは SB です。



実装
    public static function get hasScreenBroadcast():Boolean
hasScreenPlaybackプロパティ 
hasScreenPlayback:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

Flash Media Server を通して実行されているスクリーンブロードキャストアプリケーションの再生がシステムでサポートされているか (true)、またはサポートされていないか (false) を指定します。サーバーストリングは SP です。



実装
    public static function get hasScreenPlayback():Boolean
hasStreamingAudioプロパティ 
hasStreamingAudio:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムがストリーミングオーディオを再生できるか (true)、またはできないか (false) を指定します。サーバーストリングは SA です。



実装
    public static function get hasStreamingAudio():Boolean
hasStreamingVideoプロパティ 
hasStreamingVideo:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

システムがストリーミングビデオを再生できるか (true)、またはできないか (false) を指定します。サーバーストリングは SV です。



実装
    public static function get hasStreamingVideo():Boolean
hasTLSプロパティ 
hasTLS:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

NetConnection によるネイティブ SSL ソケットがサポートされているか (true)、またはサポートされていないか (false) を指定します。サーバーストリングは TLS です。



実装
    public static function get hasTLS():Boolean

関連項目

hasVideoEncoderプロパティ 
hasVideoEncoder:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

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



実装
    public static function get hasVideoEncoder():Boolean
isDebuggerプロパティ 
isDebugger:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

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



実装
    public static function get isDebugger():Boolean
isEmbeddedInAcrobatプロパティ 
isEmbeddedInAcrobat:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 9.0.127.0, AIR 1.1

PDF ファイルに埋め込まれているプレーヤーが Acrobat 9.0 以降で開くか (true)、またはそうではないか (false) を指定します。



実装
    public static function get isEmbeddedInAcrobat():Boolean
languageプロパティ 
language:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

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

英語のシステムでは、このプロパティは言語コード (en) のみを返し、国コードは返しません。Microsoft Windows システムでは、このプロパティはユーザーインターフェイス (UI) 言語を返します。UI 言語は、すべてのメニュー、ダイアログボックス、エラーメッセージ、ヘルプファイルなどで使用される言語です。次の表に、指定できる値を示します。

言語
チェコ語cs
デンマーク語da
オランダ語nl
英語en
フィンランド語fi
フランス語fr
ドイツ語de
ハンガリー語hu
イタリア語it
日本語ja
韓国語ko
ノルウェー語no
その他/不明xu
ポーランド語pl
ポルトガル語pt
ロシア語ru
簡体字中国語zh-CN
スペイン語es
スウェーデン語sv
繁体字中国語zh-TW
トルコ語tr

メモ : Capabilities.language プロパティの値は、このリストの有効な値に制限されています。この制限のために、Adobe AIR アプリケーションではシステムのユーザーインターフェイスの主言語を決定するために Capabilities.languages 配列の最初のエレメントを使用する必要があります。

サーバーストリングは 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);
        }
    }
}
AIR-only languagesプロパティ 
languages:Array  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.1

オペレーティングシステムでユーザーが選択したユーザーインターフェイスの言語に関する情報を含むストリングの配列です。このストリングには、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 です。



実装
    public static function get languages():Array
localFileReadDisableプロパティ 
localFileReadDisable:Boolean  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

ユーザーのハードディスクへの読み取りアクセスが管理上禁止されているか (true)、または許可されているか (false) を指定します。Adobe AIR のコンテンツでは、このプロパティはアプリケーションセキュリティサンドボックス以外のセキュリティサンドボックス内のコンテンツにのみ適用されます。 (アプリケーションセキュリティサンドボックス内のコンテンツは常にファイルシステムから読み取ることができます。) このプロパティが true の場合、Flash Player では、ユーザーのハードディスクからファイル (Flash Player が起動するときの最初のファイルを含む) を読み取ることができません。このプロパティが true の場合、アプリケーションセキュリティサンドボックス外の AIR コンテンツでは、ユーザーのハードディスクからファイルを読み取ることができません。たとえば、ロードメソッドを使用してユーザーのハードディスク上にあるファイルを読み取ろうとしても、このプロパティが true の場合は、読み取りに失敗します。

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

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



実装
    public static function get localFileReadDisable():Boolean

関連項目

manufacturerプロパティ 
manufacturer:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

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

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



実装
    public static function get manufacturer():String
maxLevelIDCプロパティ 
maxLevelIDC:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

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

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



実装
    public static function get maxLevelIDC():String
osプロパティ 
os:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

現在のオペレーティングシステムを指定します。os プロパティの値は、Windows XPWindows 2000Windows NTWindows 98/MEWindows 95Windows CE(Flash Player SDK でのみ使用可能。デスクトップバージョンの Flash Player では使用できません)、"Linux""Mac OS X.Y.Z"(X.Y.Z はバージョン番号。例えば Mac OS 10.5.2)テキストのいずれかです。サーバーストリングは OS です。

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



実装
    public static function get os():String
pixelAspectRatioプロパティ 
pixelAspectRatio:Number  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

画面のピクセル縦横比を指定します。サーバーストリングは AR です。



実装
    public static function get pixelAspectRatio():Number
playerTypeプロパティ 
playerType:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

ランタイム環境のタイプを指定します。このプロパティに指定できる値は、次のうちのいずれかです。

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



実装
    public static function get playerType():String
screenColorプロパティ 
screenColor:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

画面の色を指定します。このプロパティの値は、"color""gray"、(グレースケール)または "bw"(モノクロ)です。サーバーストリングは COL です。



実装
    public static function get screenColor():String
screenDPIプロパティ 
screenDPI:Number  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

画面の 1 インチあたりのドット数 (dpi) 解像度をピクセル単位で指定します。サーバーストリングは DP です。



実装
    public static function get screenDPI():Number
screenResolutionXプロパティ 
screenResolutionX:Number  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

画面の最大水平解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。このプロパティでは、ユーザーの画面の解像度は更新されませんが、その代わりに Flash Player または Adobe AIR アプリケーション起動時の解像度が示されます。また、この値はメインモニタのみ指定します。



実装
    public static function get screenResolutionX():Number

関連項目

screenResolutionYプロパティ 
screenResolutionY:Number  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

画面の最大垂直解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。このプロパティでは、ユーザーの画面の解像度は更新されませんが、その代わりに Flash Player または Adobe AIR アプリケーション起動時の解像度が示されます。また、この値はメインモニタのみ指定します。



実装
    public static function get screenResolutionY():Number

関連項目

serverStringプロパティ 
serverString:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 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  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

Flash Player または Adobe® AIR のプラットフォームとバージョン情報を指定します。バージョン番号の書式は、platform majorVersion,minorVersion,buildNumber,internalBuildNumber です。platform の有効な値は、"WIN"、` "MAC"、および "LNX" です。バージョン情報の例を次に示します。

  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
  

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

サーバーストリングは 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/flex/3_jp/langref/flash/system/Capabilities.html