| 言語バージョン : | 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 プロパティ | サーバーストリング |
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 クラスのプロパティは、すべて読み取り専用です。
例を表示
avHardwareDisable:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
ユーザーのカメラとマイクへのアクセスが管理上禁止されているか (true)、または許可されているか (false) を指定します。サーバーストリングは AVD です。
実装
public static function get avHardwareDisable():Boolean
関連項目
hasAccessibility:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が実行されている環境でアクセシビリティ補助との通信がサポートされているか (true)、またはサポートされていないか (false) を指定します。サーバーストリングは ACC です。
実装
public static function get hasAccessibility():Boolean
関連項目
hasAudio:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が実行されているシステムにオーディオ機能があるかどうかを指定します。このプロパティは常に true です。サーバーストリングは A です。
実装
public static function get hasAudio():Boolean
hasAudioEncoder:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が、マイクからの入力などのオーディオストリームをエンコードできるか (true)、またはできないか (false) を指定します。サーバーストリングは AE です。
実装
public static function get hasAudioEncoder():Boolean
hasEmbeddedVideo:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が実行されているシステムで埋め込みビデオがサポートされているか (true)、またはサポートされていないか (false) を指定します。サーバーストリングは EV です。
実装
public static function get hasEmbeddedVideo():Boolean
hasIME:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が実行されているシステムに IME がインストールされているか (true)、またはインストールされていないか (false) を指定します。サーバーストリングは IME です。
実装
public static function get hasIME():Boolean
関連項目
hasMP3:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が実行されているシステムに MP3 デコーダがあるか (true)、またはないか (false) を指定します。サーバーストリングは MP3 です。
実装
public static function get hasMP3():Boolean
関連項目
hasPrinting:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が実行されているシステムで印刷がサポートされているか (true)、またはサポートされていないか (false) を指定します。サーバーストリングは PR です。
実装
public static function get hasPrinting():Boolean
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: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:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player がストリーミングオーディオを再生できるか (true)、またはできないか (false) を指定します。サーバーストリングは SA です。
実装
public static function get hasStreamingAudio():Boolean
hasStreamingVideo:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player がストリーミングビデオを再生できるか (true)、またはできないか (false) を指定します。サーバーストリングは SV です。
実装
public static function get hasStreamingVideo():Boolean
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:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player が、Web カメラからの入力などのビデオストリームをエンコードできるか (true)、またはできないか (false) を指定します。サーバーストリングは VE です。
実装
public static function get hasVideoEncoder():Boolean
isDebugger:Boolean [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player がデバッグ用の特別なバージョンか (true)、または正式にリリースされたバージョンか (false) を指定します。サーバーストリングは DEB です。
実装
public static function get isDebugger():Boolean
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: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: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: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:Number [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
画面のピクセル縦横比を指定します。サーバーストリングは AR です。
実装
public static function get pixelAspectRatio():Number
playerType:String [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Flash Player の種類を指定します。このプロパティに指定できる値は、次のうちのいずれかです。
"StandAlone" - スタンドアローン Flash Player
"External" - 外部 Flash Player またはプレビューモード
"PlugIn" - Flash Player ブラウザプラグイン
"ActiveX" - Microsoft Internet Explorer で使用される Flash Player ActiveX コントロール
サーバーストリングは PT です。
実装
public static function get playerType():String
screenColor:String [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
画面の色を指定します。このプロパティの値は、"color"、"gray" (グレースケール)、または "bw" (モノクロ) です。サーバーストリングは COL です。
実装
public static function get screenColor():String
screenDPI:Number [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
画面の 1 インチあたりのドット数 (dpi) 解像度をピクセル単位で指定します。サーバーストリングは DP です。
実装
public static function get screenDPI():Number
screenResolutionX:Number [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
画面の最大水平解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。
実装
public static function get screenResolutionX():Number
関連項目
screenResolutionY:Number [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
画面の最大垂直解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。
実装
public static function get screenResolutionY():Number
関連項目
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: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
関連項目
次の例では、
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-2007 Adobe Systems Incorporated. All rights reserved.
Tue Oct 16 2007, 12:01 AM GMT-07:00
現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/flash/system/Capabilities.html