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

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 プロパティ サーバーストリング
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
os OS
pixelAspectRatio AR
playerType PT
screenColor COL
screenDPI DP
screenResolutionX R
screenResolutionY R
version V

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

例の表示

関連項目

Flex における Flash Player バージョンの判断
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
パブリックメソッド
 メソッド定義
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 InheritedtoString():String
指定されたオブジェクトのストリング表現を返します。
Object
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
プロパティの詳細
avHardwareDisableプロパティ
avHardwareDisable:Boolean  [read-only]

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

実装
    public static function get avHardwareDisable():Boolean

関連項目

flash.media.Camera.getCamera()
flash.media.Microphone.getMicrophone()
Security.showSettings()
Flash Player セキュリティ
hasAccessibilityプロパティ 
hasAccessibility:Boolean  [read-only]

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

実装
    public static function get hasAccessibility():Boolean

関連項目

flash.accessibility.Accessibility.active
flash.accessibility.Accessibility.updateProperties()
hasAudioプロパティ 
hasAudio:Boolean  [read-only]

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

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

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

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

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

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

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

実装
    public static function get hasIME():Boolean

関連項目

flash.system.IME
flash.system.System.ime
IME クラス
hasMP3プロパティ 
hasMP3:Boolean  [read-only]

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

実装
    public static function get hasMP3():Boolean

関連項目

Capabilities クラス
hasPrintingプロパティ 
hasPrinting:Boolean  [read-only]

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

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

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

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

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

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

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

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

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

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

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

実装
    public static function get hasTLS():Boolean

関連項目

flash.net.NetConnection.connectedProxyType
flash.net.NetConnection.proxyType
flash.net.NetConnection.usingTLS
hasVideoEncoderプロパティ 
hasVideoEncoder:Boolean  [read-only]

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

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

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

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

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
localFileReadDisableプロパティ 
localFileReadDisable:Boolean  [read-only]

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

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

実装
    public static function get localFileReadDisable():Boolean

関連項目

flash.display.Loader
Flash Player セキュリティ
manufacturerプロパティ 
manufacturer:String  [read-only]

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

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

現在のオペレーティングシステムを指定します。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]

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

実装
    public static function get pixelAspectRatio():Number
playerTypeプロパティ 
playerType:String  [read-only]

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

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

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

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

実装
    public static function get screenColor():String
screenDPIプロパティ 
screenDPI:Number  [read-only]

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

実装
    public static function get screenDPI():Number
screenResolutionXプロパティ 
screenResolutionX:Number  [read-only]

画面の最大水平解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。

実装
    public static function get screenResolutionX():Number

関連項目

Capabilities クラス
screenResolutionYプロパティ 
screenResolutionY:Number  [read-only]

画面の最大垂直解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。

実装
    public static function get screenResolutionY():Number

関連項目

Capabilities クラス
serverStringプロパティ 
serverString:String  [read-only]

それぞれの 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

関連項目

Capabilities クラス
versionプロパティ 
version:String  [read-only]

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

WIN 9,0,0,0  // Flash Player 9 for Windows
MAC 7,0,25,0   // Flash Player 7 for Macintosh
UNIX 5,0,55,0  // Flash Player 5 for UNIX

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

実装
    public static function get version():String

関連項目

Capabilities クラス
例

次の例では、 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);
        }
    }
}



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
2006.08.17, 午後 11:21, GMT-07:00

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/flash/system/Capabilities.html