| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Capabilities クラスでは、SWF ファイルをホスティングするシステムとプレーヤーを記述するプロパティが提供されています。例えば、携帯電話の画面は 100 × 100 ピクセル、モノクロで、PC の画面は 1000 × 1000 ピクセル、カラーである場合があります。Capabilities オブジェクトを使用してユーザーが使用しているデバイスのタイプを確認することによって、できるだけ多数のユーザーに対して適切なコンテンツを提供できます。デバイスの機能がわかると、適切な SWF ファイルを送るようにサーバーに指示したり、表示形式を変更するように SWF ファイルに指示したりすることができます。
機能情報 (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 クラスのプロパティは、すべて読み取り専用です。
例を表示
avHardwareDisable:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ユーザーのカメラとマイクへのアクセスが管理上禁止されているか(true)、または許可されているか(false)を指定します。 サーバーストリングは AVD です。
Adobe AIR™ のコンテンツでは、このプロパティはアプリケーションセキュリティサンドボックス以外のセキュリティサンドボックス内のコンテンツにのみ適用されます。アプリケーションセキュリティサンドボックス内のコンテンツは常にユーザーのカメラとマイクにアクセスできます。
実装 public static function get avHardwareDisable():Boolean関連項目
hasAccessibility:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムがアクセシビリティ補助との通信をサポートしているか(true)、またはサポートしていないか(false)を指定します。 サーバーストリングは ACC です。
実装 public static function get hasAccessibility():Boolean関連項目
hasAudio:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムにオーディオ機能があるかどうかを指定します。このプロパティは常に true です。 サーバーストリングは A です。
実装 public static function get hasAudio():BooleanhasAudioEncoder:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムが、マイクからの入力などのオーディオストリームをエンコードできるか(true)、またはできないか(false)を指定します。 サーバーストリングは AE です。
実装 public static function get hasAudioEncoder():BooleanhasEmbeddedVideo:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムが埋め込みビデオをサポートしているか(true)、またはサポートしていないか(false)を指定します。 サーバーストリングは EV です。
実装 public static function get hasEmbeddedVideo():BooleanhasIME:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムに IME がインストールされているか(true)、またはインストールされていないか(false)を指定します。 サーバーストリングは IME です。
実装 public static function get hasIME():Boolean関連項目
hasMP3:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムに MP3 デコーダが存在するか(true)、または存在しないか(false)を指定します。 サーバーストリングは MP3 です。
実装 public static function get hasMP3():Boolean関連項目
hasPrinting:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムが印刷をサポートしているか(true)、またはサポートしていないか(false)を指定します。 サーバーストリングは PR です。
実装 public static function get hasPrinting():BooleanhasScreenBroadcast:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Flash Media Server を通して実行されるスクリーンブロードキャストアプリケーションの開発がシステムでサポートされているか(true)、またはサポートされていないか(false)を指定します。 サーバーストリングは SB です。
実装 public static function get hasScreenBroadcast():BooleanhasScreenPlayback:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Flash Media Server を通して実行されているスクリーンブロードキャストアプリケーションの再生がシステムでサポートされているか(true)、またはサポートされていないか(false)を指定します。 サーバーストリングは SP です。
実装 public static function get hasScreenPlayback():BooleanhasStreamingAudio:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムがストリーミングオーディオを再生できるか(true)、またはできないか(false)を指定します。 サーバーストリングは SA です。
実装 public static function get hasStreamingAudio():BooleanhasStreamingVideo:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムがストリーミングビデオを再生できるか(true)、またはできないか(false)を指定します。 サーバーストリングは SV です。
実装 public static function get hasStreamingVideo():BooleanhasTLS:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
NetConnection によるネイティブ SSL ソケットがサポートされているか(true)、またはサポートされていないか(false)を指定します。 サーバーストリングは TLS です。
実装 public static function get hasTLS():Boolean関連項目
hasVideoEncoder:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
システムが、Web カメラからの入力などのビデオストリームをエンコードできるか(true)、またはできないか(false)を指定します。 サーバーストリングは VE です。
実装 public static function get hasVideoEncoder():BooleanisDebugger: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():BooleanisEmbeddedInAcrobat:Boolean [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 9.0.127.0, AIR 1.1 |
Flash Player が、Acrobat 9.0 以降で開いている PDF ファイルに埋め込まれているか(true)、またはそうでないか(false)を指定します。
実装 public static function get isEmbeddedInAcrobat():Boolean関連項目
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);
}
}
}
languages:Array [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
オペレーティングシステムでユーザーが選択したユーザーインターフェイスの言語に関する情報を含むストリングの配列です。このストリングには、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():ArraylocalFileReadDisable: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:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Flash Player の実行バージョンまたは AIR ランタイムの実行バージョンの製造会社を「Adobe OSName」の形式で指定します。 OSName の値は、「Windows」、「Macintosh」、「Linux」、または別のオペレーティングシステム名になります。 サーバーストリングは M です。
実装 public static function get manufacturer():StringmaxLevelIDC:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
クライアントハードウェアがサポートする H.264 の最高レベルの IDC を取得します。このレベルでのメディア実行は保証されますが、最高レベルでのメディア実行は最高品質では実行されない場合があります。このプロパティは、クライアントの機能をターゲットとするサーバーに役立ちます。このプロパティを使用すると、サーバーはクライアントに送るビデオのレベルを決定できます。
サーバーストリングは ML です。
実装 public static function get maxLevelIDC():Stringos:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
現在のオペレーティングシステムを指定します。os プロパティの値は、「Windows XP」、「Windows 2000」、「Windows NT」、「Windows 98/ME」、「Windows 95」、「Windows CE」(Flash Player SDK でのみ使用可能。デスクトップバージョンの Flash Player では使用できません)、「Linux」、「Mac OS X.Y.Z」(X.Y.Z はバージョン番号。例えば Mac OS 10.5.2 テキストのいずれかです。 サーバーストリングは OS です。
実装 public static function get os():StringpixelAspectRatio:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
画面のピクセル縦横比を指定します。サーバーストリングは AR です。
実装 public static function get pixelAspectRatio():NumberplayerType:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ランタイム環境のタイプを指定します。このプロパティに指定できる値は、次のうちのいずれかです。
-
"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 です。
実装 public static function get playerType():StringscreenColor:String [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
画面の色を指定します。このプロパティの値は、「color」、「gray」(グレースケール)または「bw」(モノクロ)です。 サーバーストリングは COL です。
実装 public static function get screenColor():StringscreenDPI:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
画面の 1 インチあたりのドット数(dpi)解像度をピクセル単位で指定します。サーバーストリングは DP です。
実装 public static function get screenDPI():NumberscreenResolutionX:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
画面の最大水平解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。このプロパティでは、ユーザーの画面の解像度は更新されませんが、その代わりに Flash Player または Adobe AIR アプリケーション起動時の解像度が示されます。 また、この値はメインモニタのみ指定します。
実装 public static function get screenResolutionX():Number関連項目
screenResolutionY:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
画面の最大垂直解像度を指定します。サーバーストリングは R で、画面の幅と高さの両方を返します。このプロパティでは、ユーザーの画面の解像度は更新されませんが、その代わりに Flash Player または Adobe AIR アプリケーション起動時の解像度が示されます。 また、この値はメインモニタのみ指定します。
実装 public static function get screenResolutionY():Number関連項目
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: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
サーバーストリングは 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-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 12:14 AM -08:00