Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
flash.system 

Capabilities  - AS3

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

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

Capabilities クラスは、アプリケーションをホスティングするシステムとランタイムを記述するプロパティを提供します。例えば、携帯電話の画面は 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&DD=f&
     DDP=f&DTS=f&DTE=f&DTH=f&DTM=f

次の表に、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
supports Dolby Digital audio DD
supports Dolby Digital Plus audio DDP
supports DTS audio DTS
supports DTS Express audio DTE
supports DTS-HD High Resolution Audio DTH
supports DTS-HD Master Audio DTM

ウィンドウレスモードが無効化されているかどうかを示す WD サーバーストリングもあります。Flash Player では、Web ブラウザーまたは mms.cfg ファイルのユーザー設定との不適合という理由でウィンドウレスモードを無効化できます。対応する Capabilities プロパティはありません。

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

例を表示

さらに例を参照



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

avHardwareDisable

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

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

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

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



実装
    public static function get avHardwareDisable():Boolean

関連する API エレメント

cpuArchitecture

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

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

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



実装
    public static function get cpuArchitecture():String

hasAccessibility

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

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

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



実装
    public static function get hasAccessibility():Boolean

関連する API エレメント

hasAudio

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

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

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



実装
    public static function get hasAudio():Boolean

hasAudioEncoder

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

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

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



実装
    public static function get hasAudioEncoder():Boolean

hasEmbeddedVideo

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

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

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



実装
    public static function get hasEmbeddedVideo():Boolean

hasIME

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

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

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



実装
    public static function get hasIME():Boolean

関連する API エレメント

hasMP3

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

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

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



実装
    public static function get hasMP3():Boolean

hasPrinting

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

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

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



実装
    public static function get hasPrinting():Boolean

hasScreenBroadcast

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

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

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



実装
    public static function get hasScreenBroadcast():Boolean

hasScreenPlayback

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

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

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



実装
    public static function get hasScreenPlayback():Boolean

hasStreamingAudio

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

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

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



実装
    public static function get hasStreamingAudio():Boolean

hasStreamingVideo

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

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

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



実装
    public static function get hasStreamingVideo():Boolean

hasTLS

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

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

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



実装
    public static function get hasTLS():Boolean

関連する API エレメント

hasVideoEncoder

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

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

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



実装
    public static function get hasVideoEncoder():Boolean

isDebugger

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

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

システムがデバッグ用の特別なバージョンか(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, Flash Lite 4

Flash ランタイムが、Acrobat 9.0 以降で開くことができる PDF ファイルに埋め込まれているか(true)、またはそうでないか(false)を指定します。



実装
    public static function get isEmbeddedInAcrobat():Boolean

language

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

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

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

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

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

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

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



実装
    public static function get language():String

関連する API エレメント


例  ( この例の使用方法 )
次の例では、ユーザーのオペレーティングシステムの言語により異なるコンテンツが表示されます。

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

プロパティ 
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
ランタイムバージョン: Flash Player 9, AIR 1.0, Flash Lite 4

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

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

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



実装
    public static function get localFileReadDisable():Boolean

関連する API エレメント

manufacturer

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

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

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, Flash Lite 4

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

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



実装
    public static function get maxLevelIDC():String

os

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

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

現在のオペレーティングシステムを指定します。os プロパティは、次のストリングを返すことができます。

オペレーティングシステム
Windows 10"Windows 10"
Windows 8"Windows 8"
Windows 7"Windows 7"
Windows Vista"Windows Vista"
Windows Server 2012"Windows Server 2012"
Windows Server 2008 R2"Windows Server 2008 R2"
Windows Server 2008"Windows Server 2008"
Windows Home Server"Windows Home Server"
Windows Server 2003 R2"Windows Server 2003 R2"
Windows Server 2003"Windows Server 2003"
Windows XP 64"Windows Server XP 64"
Windows XP"Windows XP"
Windows 98"Windows-98"
Windows 95"Windows 95"
Windows NT"Windows NT"
Windows 2000"Windows 2000"
Windows ME"Windows ME"
Windows CE"Windows CE"
Windows SmartPhone"Windows SmartPhone"
Windows PocketPC"Windows PocketPC"
Windows CEPC"Windows CEPC"
Windows Mobile"Windows Mobile"
Mac OS"Mac OS X.Y.Z"(X.Y.Z はバージョン番号。例:"Mac OS 10.5.2"
Linux"Linux"(Flash Player では Linux バージョンが付加されます。例:"Linux 2.6.15-1.2054_FC5smp"
iPhone OS 4.1"iPhone3,1"

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

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



実装
    public static function get os():String

pixelAspectRatio

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

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

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



実装
    public static function get pixelAspectRatio():Number

playerType

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

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

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

  • "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():String

screenColor

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

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

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



実装
    public static function get screenColor():String

screenDPI

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

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

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



実装
    public static function get screenDPI():Number

screenResolutionX

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

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

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



実装
    public static function get screenResolutionX():Number

screenResolutionY

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

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

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



実装
    public static function get screenResolutionY():Number

例  ( この例の使用方法 )
次の例は、現在の画面の解像度とオペレーティングシステムのバージョンを表示する簡単なテストです。テストを実行したら、テキストフィールドをクリックして、プロパティの値を確認します。
import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;

addChild(screenInfoTxt);

addEventListener(MouseEvent.CLICK, getScreenNVersion);

function getScreenNVersion(e:MouseEvent):void{
    screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
    "flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
    "flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}

serverString

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

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

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

supports32BitProcesses

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

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

32 bit プロセスの実行がサポートされているかどうかを指定します。サーバーストリングは PR32 です。



実装
    public static function get supports32BitProcesses():Boolean

supports64BitProcesses

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

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

64 bit プロセスの実行がサポートされているかどうかを指定します。サーバーストリングは PR64 です。



実装
    public static function get supports64BitProcesses():Boolean

touchscreenType

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

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

タッチスクリーンがサポートされる場合、そのタッチスクリーンの種類を指定します。flash.system.TouchscreenType クラスに定義されている値です。



実装
    public static function get touchscreenType():String

関連する API エレメント


例  ( この例の使用方法 )
次の例は、現在のタッチスクリーンの種類を表示する簡単なテストです。テストを実行したら、テキストフィールドをクリックして、プロパティの値を確認します。
import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var capabilitiesTouchScreenTypeTxt:TextField = new TextField();
capabilitiesTouchScreenTypeTxt.width = 300;
capabilitiesTouchScreenTypeTxt.border = true;

addChild(capabilitiesTouchScreenTypeTxt);

addEventListener(MouseEvent.CLICK, getScreenKeyboardType);

function getScreenKeyboardType(e:MouseEvent):void{
    capabilitiesTouchScreenTypeTxt.text= "flash.system.Capabilities.touchscreenType is : " + flash.system.Capabilities.touchscreenType;
}

version

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

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

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

	 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
	 AND 10,2,150,0 // Flash Player 10 for Android
	 

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

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



実装
    public static function get version():String

例  ( この例の使用方法 )
次の例は、現在の画面の解像度とオペレーティングシステムのバージョンを表示する簡単なテストです。テストを実行したら、テキストフィールドをクリックして、プロパティの値を確認します。
import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;

addChild(screenInfoTxt);

addEventListener(MouseEvent.CLICK, getScreenNVersion);

function getScreenNVersion(e:MouseEvent):void{
    screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
    "flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
    "flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}
メソッドの詳細

hasMultiChannelAudio

()メソッド
public static function hasMultiChannelAudio(type:String):Boolean

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

特定のタイプのマルチチャンネルオーディオをシステムがサポートするかどうかを指定します。flash.media.AudioDecoder クラスで考えられるタイプが列挙されます。

AIR プロファイルのサポート:マルチチャンネルオーディオは AIR for TV デバイスでのみサポートされます。他のすべてのデバイスでは、このメソッドは常に false を返します。複数のプロファイル間での API サポートについて詳しくは、AIR プロファイルのサポートを参照してください。

注意:いずれかの DTS オーディオコーデックを使用している場合は、hasMultiChannelAudio()true を返しても DTS オーディオが再生されないシナリオが存在します。例えば、S/PDIF 出力を備えたブルーレイプレーヤーを古いアンプに接続している場合について考えてみます。古いアンプは DTS に対応していませんが、S/PDIF にはブルーレイプレーヤーに通知するプロトコルがありません。ブルーレイプレーヤーから古いアンプに DTS ストリームが送信されても、ユーザーには何も聞こえません。したがって、ベストプラクティスとして、DTS を使用するときは、サウンドが再生されていないときにユーザーが指摘できるように、ユーザーインターフェイスを提供してください。そうすれば、アプリケーションは別のコーデックに復帰できます。

次の表に、各マルチチャンネルオーディオタイプに対するサーバーストリングを示します。

マルチチャンネルオーディオタイプサーバーストリング
AudioDecoder.DOLBY_DIGITALDD
AudioDecoder.DOLBY_DIGITAL_PLUSDDP
AudioDecoder.DTSDTS
AudioDecoder.DTS_EXPRESSDTE
AudioDecoder.DTS_HD_HIGH_RESOLUTION_AUDIODTH
AudioDecoder.DTS_HD_MASTER_AUDIODTM

パラメーター

type:String — マルチチャンネルオーディオタイプを表すストリング値。有効な値は、flash.media.AudioDecoder に定義されている定数です。

戻り値
Booleantype パラメーターに渡されたマルチチャンネルオーディオタイプをシステムがサポートする場合は、ブール値 true。それ以外の場合、戻り値は false です。

関連する API エレメント


例  ( この例の使用方法 )
次のコードは、hasMultiChannelAudio() の呼び出しの戻り値をトレースします。この戻り値は、システムがドルビーデジタルマルチチャンネルオーディオをサポートするかどうかを示します。
    trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);
    
CapabilitiesExample.as

次の例では、flash.system.Capabilities オブジェクトで見つかった値を出力します。最初に、テキストフィールドに値を出力します。次に、trace() の呼び出しを複数個使用して値を出力します。
package {
    import flash.display.Sprite;
    import flash.system.Capabilities;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class CapabilitiesExample extends Sprite {
        
        public function CapabilitiesExample() {
            showCapabilities();
        }
        
        private function showCapabilities():void {
            var tf:TextField = new TextField();
            tf.height = 600;
            tf.width = 400;
            tf.autoSize = TextFieldAutoSize.LEFT;
            tf.wordWrap = true;
            
            tf.text = "avHardwareDisable: " + Capabilities.avHardwareDisable +
                
                "\nhasAccessibility: " + Capabilities.hasAccessibility +
                "\nhasAudio: " + Capabilities.hasAudio +
                "\nhasAudioEncoder: " + Capabilities.hasAudioEncoder +
                "\nhasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo +
                "\nhasIME: " + Capabilities.hasIME +
                "\nhasMP3: " + Capabilities.hasMP3 +
                "\nhasPrinting: " + Capabilities.hasPrinting +
                "\nhasScreenBroadcast: " + Capabilities.hasScreenBroadcast +
                "\nhasScreenPlayback: " + Capabilities.hasScreenPlayback +
                "\nhasStreamingAudio: " + Capabilities.hasStreamingAudio +
                "\nhasStreamingVideo: " + Capabilities.hasStreamingVideo +
                "\nhasTLS: " + Capabilities.hasTLS +
                "\nhasVideoEncoder: " + Capabilities.hasVideoEncoder +
                "\nisDebugger: " + Capabilities.isDebugger +
                "\nisEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat +
                "\nlanguage: " + Capabilities.language +
                "\nlocalFileReadDisable: " + Capabilities.localFileReadDisable +
                "\nmanufacturer: " + Capabilities.manufacturer +
                "\nmaxLevelIDC: " + Capabilities.maxLevelIDC +
                "\nos: " + Capabilities.os +
                "\npixelAspectRatio: " + Capabilities.pixelAspectRatio +
                "\nplayerType: " + Capabilities.playerType +
                "\nscreenColor: " + Capabilities.screenColor +
                "\nscreenDPI: " + Capabilities.screenDPI +
                "\nscreenResolutionX: " + Capabilities.screenResolutionX +
                "\nscreenResolutionY: " + Capabilities.screenResolutionY +
                "\nserverString: " + Capabilities.serverString +
                "\ntouchscreenType: " + Capabilities.touchscreenType +
                
                // The following capabilities are supported only when publishing for AIR.
                // If you are publishing for AIR, uncomment the following lines.
                //"\nlanguages: " + Capabilities.languages +
                //"\ncpuArchitecture: " + Capabilities.cpuArchitecture +
                //"\nsupports32BitProcesses: " + Capabilities.supports32BitProcesses +
                //"\nsupports64BitProcesses: " + Capabilities.supports64BitProcesses +    
                                
                "\nversion: " + Capabilities.version;
                
            addChild(tf);   
                
            trace("avHardwareDisable: " + Capabilities.avHardwareDisable);
            trace("hasAccessibility: " + Capabilities.hasAccessibility);
            trace("hasAudio: " + Capabilities.hasAudio);
            trace("hasAudioEncoder: " + Capabilities.hasAudioEncoder);
            trace("hasEmbeddedVideo: " + Capabilities.hasEmbeddedVideo);
            trace("hasIME: " + Capabilities.hasIME);
            trace("hasMP3: " + Capabilities.hasMP3);
            trace("hasPrinting: " + Capabilities.hasPrinting);
            trace("hasScreenBroadcast: " + Capabilities.hasScreenBroadcast);
            trace("hasScreenPlayback: " + Capabilities.hasScreenPlayback);
            trace("hasStreamingAudio: " + Capabilities.hasStreamingAudio);
            trace("hasStreamingVideo: " + Capabilities.hasStreamingVideo);
            trace("hasTLS: " + Capabilities.hasTLS);
            trace("hasVideoEncoder: " + Capabilities.hasVideoEncoder);
            trace("isDebugger: " + Capabilities.isDebugger);
            trace("isEmbeddedInAcrobat: " + Capabilities.isEmbeddedInAcrobat);
            trace("language: " + Capabilities.language);
            trace("localFileReadDisable: " + Capabilities.localFileReadDisable);
            trace("manufacturer: " + Capabilities.manufacturer);
            trace("maxLevelIDC: " + Capabilities.maxLevelIDC);
            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("touchscreenType: " + Capabilities.touchscreenType);
            
            // The following capabilities are supported only when publishing for AIR.
            // If you are publishing for AIR, uncomment the following lines.       
            //trace("cpuArchitecture: " + Capabilities.cpuArchitecture);
            //trace("languages: " + Capabilities.languages);
            //trace("supports32BitProcesses: " + Capabilities.supports32BitProcesses);
            //trace("supports64BitProcesses: " + Capabilities.supports64BitProcesses);        
                        
            trace("version: " + Capabilities.version);
       
        }
    }
}





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。