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

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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

GET または POST HTTP メソッドを使用すると、プレーヤーの機能情報を送信できます。この情報は、Capabilities.serverString プロパティに URL エンコードされたストリングとして格納されています。次に、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

次の表は、使用できる 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 クラスの使用


パブリック プロパティ
 プロパティ定義元
  avHardwareDisable : Boolean
[static] [read-only] ユーザーのカメラとマイクへのアクセスが管理上禁止されているか (true)、または許可されているか (false) を指定します。
Capabilities
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  hasAccessibility : Boolean
[static] [read-only] Flash Player が実行されている環境でアクセシビリティ補助との通信がサポートされているか (true)、またはサポートされていないか (false) を指定します。
Capabilities
  hasAudio : Boolean
[static] [read-only] Flash Player が実行されているシステムにオーディオ機能があるかどうかを指定します。
Capabilities
  hasAudioEncoder : Boolean
[static] [read-only] Flash Player が、マイクからの入力などのオーディオストリームをエンコードできるか (true)、またはできないか (false) を指定します。
Capabilities
  hasEmbeddedVideo : Boolean
[static] [read-only] Flash Player が実行されているシステムで埋め込みビデオがサポートされているか (true)、またはサポートされていないか (false) を指定します。
Capabilities
  hasIME : Boolean
[static] [read-only] Flash Player が実行されているシステムに IME がインストールされているか (true)、またはインストールされていないか (false) を指定します。
Capabilities
  hasMP3 : Boolean
[static] [read-only] Flash Player が実行されているシステムに MP3 デコーダがあるか (true)、またはないか (false) を指定します。
Capabilities
  hasPrinting : Boolean
[static] [read-only] Flash Player が実行されているシステムで印刷がサポートされているか (true)、またはサポートされていないか (false) を指定します。
Capabilities
  hasScreenBroadcast : Boolean
[static] [read-only] Flash Media Server を通して実行されるスクリーンブロードキャストアプリケーションの開発が Flash Player でサポートされているか (true)、またはサポートされていないか (false) を指定します。
Capabilities
  hasScreenPlayback : Boolean
[static] [read-only] Flash Media Server を通して実行されているスクリーンブロードキャストアプリケーションの再生が Flash Player でサポートされているか (true)、またはサポートされていないか (false) を指定します。
Capabilities
  hasStreamingAudio : Boolean
[static] [read-only] Flash Player がストリーミングオーディオを再生できるか (true)、またはできないか (false) を指定します。
Capabilities
  hasStreamingVideo : Boolean
[static] [read-only] Flash Player がストリーミングビデオを再生できるか (true)、またはできないか (false) を指定します。
Capabilities
  hasTLS : Boolean
[static] [read-only] Flash Player が実行されているシステムで NetConnection によるネイティブ SSL ソケットがサポートされているか (true)、またはサポートされていないか (false) を指定します。
Capabilities
  hasVideoEncoder : Boolean
[static] [read-only] Flash Player が、Web カメラからの入力などのビデオストリームをエンコードできるか (true)、またはできないか (false) を指定します。
Capabilities
  isDebugger : Boolean
[static] [read-only] Flash Player がデバッグ用の特別なバージョンか (true)、または正式にリリースされたバージョンか (false) を指定します。
Capabilities
  language : String
[static] [read-only] Flash Player が実行されているシステムの言語コードを指定します。
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] Flash Player の種類を指定します。
Capabilities
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  screenColor : String
[static] [read-only] 画面の色を指定します。
Capabilities
  screenDPI : Number
[static] [read-only] 画面の 1 インチあたりのドット数 (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
パブリック メソッド
 メソッド定義元
 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

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


実装
    public static function get hasAccessibility():Boolean

関連項目

hasAudioプロパティ 
hasAudio:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasAudio():Boolean
hasAudioEncoderプロパティ 
hasAudioEncoder:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasAudioEncoder():Boolean
hasEmbeddedVideoプロパティ 
hasEmbeddedVideo:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasEmbeddedVideo():Boolean
hasIMEプロパティ 
hasIME:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasIME():Boolean

関連項目

hasMP3プロパティ 
hasMP3:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

Flash Player が実行されているシステムに MP3 デコーダがあるか (true)、またはないか (false) を指定します。サーバーストリングは MP3 です。


実装
    public static function get hasMP3():Boolean

関連項目

hasPrintingプロパティ 
hasPrinting:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasPrinting():Boolean
hasScreenBroadcastプロパティ 
hasScreenBroadcast:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasScreenBroadcast():Boolean
hasScreenPlaybackプロパティ 
hasScreenPlayback:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasScreenPlayback():Boolean
hasStreamingAudioプロパティ 
hasStreamingAudio:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasStreamingAudio():Boolean
hasStreamingVideoプロパティ 
hasStreamingVideo:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasStreamingVideo():Boolean
hasTLSプロパティ 
hasTLS:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasTLS():Boolean

関連項目

hasVideoEncoderプロパティ 
hasVideoEncoder:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public static function get hasVideoEncoder():Boolean
isDebuggerプロパティ 
isDebugger:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

Flash Player がデバッグ用の特別なバージョンか (true)、または正式にリリースされたバージョンか (false) を指定します。サーバーストリングは DEB です。


実装
    public static function get isDebugger():Boolean
languageプロパティ 
language:String  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

Flash Player が実行されているシステムの言語コードを指定します。言語は 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

サーバーストリングは 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 の場合は、読み取りに失敗します。

このプロパティが 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

Flash Player の種類を指定します。このプロパティに指定できる値は、次のうちのいずれかです。

サーバーストリングは 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

画面の 1 インチあたりのドット数 (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_jp/ActionScriptLangRefV3/flash/system/Capabilities.html