flash.system.Capabilities (ActionScript 3.0)

包	flash.system
类	public final class Capabilities
继承	Capabilities Object

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

Capabilities 类提供一些属性，这些属性描述了承载 SWF 文件的系统和播放器。例如，手机屏幕可以有 100 个正方形像素（黑白），而 PC 屏幕则可以有 1000 个正方形像素（彩色）。通过使用 Capabilities 对象来确定用户所拥有的设备的类型，可以向尽可能多的用户提供适当的内容。如果熟悉设备的功能，则可以通知服务器发送合适的 SWF 文件，或是通知 SWF 文件变更其播放方式。

可使用 GET 或 POST HTTP 方法发送播放器功能信息，它作为一个 URL 编码的字符串存储在 Capabilities.serverString 属性中。下例显示了支持 MP3、具有 1600 x 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 类的所有属性都是只读的。

查看示例

另请参见

使用 Capabilities 类

	属性	定义方
		avHardwareDisable : Boolean [static] [read-only] 指定对用户的摄像头和麦克风的访问是已经通过管理方式禁止 (true) 还是允许 (false)。	Capabilities
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		hasAccessibility : Boolean [static] [read-only] 指定播放器是在支持 (true) 与辅助功能进行通信的环境中运行，还是在不支持 (false) 这种功能的环境中运行。	Capabilities
		hasAudio : Boolean [static] [read-only] 指定播放器是否在具有音频功能的系统上运行。	Capabilities
		hasAudioEncoder : Boolean [static] [read-only] 指定播放器能 (true) 还是不能 (false) 对音频流（如来自麦克风的音频流）进行编码。	Capabilities
		hasEmbeddedVideo : Boolean [static] [read-only] 指定播放器是在支持 (true) 嵌入视频的系统上运行，还是在不支持 (false) 嵌入视频的系统上运行。	Capabilities
		hasIME : Boolean [static] [read-only] 指定播放器是在安装有 (true) 输入法编辑器 (IME) 的系统上运行，还是在未安装 (false) IME 的系统上运行。	Capabilities
		hasMP3 : Boolean [static] [read-only] 指定播放器是在具有 (true) MP3 解码器的系统上运行，还是在没有 (false) MP3 解码器的系统上运行。	Capabilities
		hasPrinting : Boolean [static] [read-only] 指定播放器是在支持 (true) 打印的系统上运行，还是在不支持 (false) 打印的系统上运行。	Capabilities
		hasScreenBroadcast : Boolean [static] [read-only] 指定播放器是支持 (true) 开发通过 Flash Media Server 运行的屏幕广播应用程序，还是不支持 (false) 开发这类应用程序。	Capabilities
		hasScreenPlayback : Boolean [static] [read-only] 指定播放器是支持 (true) 通过 Flash Media Server 运行的屏幕广播应用程序的回放，还是不支持 (false) 这类应用程序的回放。	Capabilities
		hasStreamingAudio : Boolean [static] [read-only] 指定播放器能 (true) 还是不能 (false) 播放音频流。	Capabilities
		hasStreamingVideo : Boolean [static] [read-only] 指定播放器能 (true) 还是不能 (false) 播放视频流。	Capabilities
		hasTLS : Boolean [static] [read-only] 指定播放器是 (true) 否 (false) 位于通过 NetConnection 支持本机 SSL 套接字的系统上。	Capabilities
		hasVideoEncoder : Boolean [static] [read-only] 指定播放器能 (true) 还是不能 (false) 对视频流（如来自 Web 摄像头的视频流）进行编码。	Capabilities
		isDebugger : Boolean [static] [read-only] 指定播放器是特殊的调试版本 (true)，还是正式发布的版本 (false)。	Capabilities
		language : String [static] [read-only] 指定运行播放器的系统的语言代码。	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] 指定播放器的类型。	Capabilities
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object
		screenColor : String [static] [read-only] 指定屏幕的颜色。	Capabilities
		screenDPI : Number [static] [read-only] 指定屏幕的每英寸点数 (dpi) 分辨率，以像素为单位。	Capabilities
		screenResolutionX : Number [static] [read-only] 指定屏幕的最大水平分辨率。	Capabilities
		screenResolutionY : Number [static] [read-only] 指定屏幕的最大垂直分辨率。	Capabilities
		serverString : String [static] [read-only] URL 编码的字符串，用于指定每个 Capabilities 属性的值。	Capabilities
		version : String [static] [read-only] 指定 Flash Player 平台和版本信息。	Capabilities

	方法	定义方
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

avHardwareDisable

属性

avHardwareDisable:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定对用户的摄像头和麦克风的访问是已经通过管理方式禁止 (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]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是在支持 (true) 与辅助功能进行通讯的环境中运行，还是在不支持 (false) 这种功能的环境中运行。服务器字符串为 ACC。

实现
public static function get hasAccessibility():Boolean

另请参见

flash.accessibility.Accessibility.active
flash.accessibility.Accessibility.updateProperties()

hasAudio

属性

hasAudio:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是否在具有音频功能的系统上运行。此属性始终为 true。服务器字符串为 A。

实现
public static function get hasAudio():Boolean

hasAudioEncoder

属性

hasAudioEncoder:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器能 (true) 还是不能 (false) 对音频流（如来自麦克风的音频流）进行编码。服务器字符串为 AE。

实现
public static function get hasAudioEncoder():Boolean

hasEmbeddedVideo

属性

hasEmbeddedVideo:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是在支持 (true) 嵌入视频的系统上运行，还是在不支持 (false) 嵌入视频的系统上运行。服务器字符串为 EV。

实现
public static function get hasEmbeddedVideo():Boolean

hasIME

属性

hasIME:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是在安装有 (true) 输入法编辑器 (IME) 的系统上运行，还是在未安装 (false) IME 的系统上运行。服务器字符串为 IME。

实现
public static function get hasIME():Boolean

另请参见

flash.system.IME
flash.system.System.ime
使用 IME 类

hasMP3

属性

hasMP3:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是在具有 (true) MP3 解码器的系统上运行，还是在没有 (false) MP3 解码器的系统上运行。服务器字符串为 MP3。

实现
public static function get hasMP3():Boolean

另请参见

使用 Capabilities 类

hasPrinting

属性

hasPrinting:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是在支持 (true) 打印的系统上运行，还是在不支持 (false) 打印的系统上运行。服务器字符串为 PR。

实现
public static function get hasPrinting():Boolean

hasScreenBroadcast

属性

hasScreenBroadcast:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是支持 (true) 开发通过 Flash Media Server 运行的屏幕广播应用程序，还是不支持 (false) 开发这类应用程序。服务器字符串为 SB。

实现
public static function get hasScreenBroadcast():Boolean

hasScreenPlayback

属性

hasScreenPlayback:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是支持 (true) 通过 Flash Media Server 运行的屏幕广播应用程序的回放，还是不支持 (false) 这类应用程序的回放。服务器字符串为 SP。

实现
public static function get hasScreenPlayback():Boolean

hasStreamingAudio

属性

hasStreamingAudio:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器能 (true) 还是不能 (false) 播放流式音频。服务器字符串为 SA。

实现
public static function get hasStreamingAudio():Boolean

hasStreamingVideo

属性

hasStreamingVideo:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器能 (true) 还是不能 (false) 播放流式视频。服务器字符串为 SV。

实现
public static function get hasStreamingVideo():Boolean

hasTLS

属性

hasTLS:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是位于通过 NetConnection 支持本机 SSL 套接字的系统上 (true)，还是安装在不通过 NetConnection 支持本机 SSL 套接字的系统上 (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]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器能 (true) 还是不能 (false) 对视频流（如来自 Web 摄像头的视频流）进行编码。服务器字符串为 VE。

实现
public static function get hasVideoEncoder():Boolean

isDebugger

属性

isDebugger:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定播放器是特殊的调试版本 (true)，还是正式发布的版本 (false)。服务器字符串为 DEB。

实现
public static function get isDebugger():Boolean

language

属性

language:String [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定运行播放器的系统的语言代码。语言指定为 ISO 639-1 中的小写双字母语言代码。对于中文，另外使用 ISO 3166 中的大写双字母国家/地区代码，以区分简体中文和繁体中文。语言代码基于语言的英文名称：例如，hu 指定匈牙利语。

在英文系统上，此属性仅返回语言代码 (en)，而不返回国家/地区代码。在 Microsoft Windows 系统上，此属性返回用户界面 (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]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定对用户硬盘的读取权限是已经通过管理方式禁止 (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]

语言版本 :

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

属性

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

指定播放器的类型。此属性可以是下列值之一：

"StandAlone"，用于独立的 Flash Player
"External"，用于外部的 Flash Player 或处于测试模式下
"PlugIn"，用于 Flash Player 浏览器插件
"ActiveX"，用于 Microsoft Internet Explorer 使用的 Flash Player ActiveX 控件

服务器字符串为 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

指定屏幕的每英寸点数 (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

另请参见

使用 Capabilities 类

screenResolutionY

属性

screenResolutionY:Number [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定屏幕的最大垂直分辨率。服务器字符串为 R（它返回屏幕的宽度和高度）。

实现
public static function get screenResolutionY():Number

另请参见

使用 Capabilities 类

serverString

属性

serverString:String [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

URL 编码的字符串，用于指定每个 Capabilities 属性的值。

以下示例显示了一个 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]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指定 Flash Player 平台和版本信息。版本号的格式为：平台 (platform)，主版本号 (majorVersion)，次版本号 (minorVersion)、生成版本号 (buildNumber)，内部生成版本号 (internalBuildNumber)。平台的可能值有 "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);
        }
    }
}

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/system/Capabilities.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
Capabilities	属性 \| 方法 \| 示例