包 | flash.system |
类 | public final class System |
继承 | System Object |
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
其他属性和方法在 flash.system 包的其他类中:Capabilities 类、IME 类和 Security 类。
此类只包含静态方法和属性。无法创建 System 类的新实例。
相关 API 元素
属性 | 由以下参数定义 | ||
---|---|---|---|
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
freeMemory : Number [静态] [只读]
分配给 Adobe® Flash® Player 或 Adobe® AIR® 的内存量以及未使用的内存量(以字节表示)。 | System | ||
ime : IME [静态] [只读]
当前安装的系统 IME。 | System | ||
privateMemory : Number [静态] [只读]
应用程序使用的内存总量(以字节表示)。 | System | ||
totalMemory : uint [静态] [只读]
当前正使用的由 Flash Player 或 AIR 直接分配的内存量(以字节表示)。 | System | ||
totalMemoryNumber : Number [静态] [只读]
当前正使用的由 Flash Player 或 AIR 直接分配的内存量(以字节表示)。 | System | ||
useCodePage : Boolean [静态]
一个布尔值,它决定使用哪个代码页来解释外部文本文件。 | System |
方法 | 由以下参数定义 | ||
---|---|---|---|
[静态]
使指定的 XML 对象立即可进行垃圾回收。 | System | ||
[静态]
关闭 Flash Player。 | System | ||
[静态]
强制执行垃圾回收进程。 | System | ||
表示对象是否已经定义了指定的属性。 | Object | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
[静态]
暂停 Flash Player 或 AIR Debug Launcher (ADL)。 | System | ||
[静态]
如果垃圾回收器的临界值超过函数的临界参数,则建议回收器应完成增量回收循环。 | System | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
[静态]
调用 System.pause() 后,恢复应用程序。 | System | ||
[静态]
用指定的文本字符串替换剪贴板的内容。 | System | ||
设置循环操作动态属性的可用性。 | Object | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object |
freeMemory | 属性 |
ime | 属性 |
privateMemory | 属性 |
totalMemory | 属性 |
totalMemory:uint
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
当前正使用的由 Flash Player 或 AIR 直接分配的内存量(以字节表示)。
此属性不返回由 Adobe AIR 应用程序或包含 Flash Player 内容的应用程序(如浏览器)使用的所有内存。浏览器或操作系统可能使用其他内存。System.privateMemory
属性反映应用程序所使用的所有内存。
如果分配的内存量大于 uint 对象的最大值(uint.MAX_VALUE
或 4,294,967,295),则此属性设置为 0。System.totalMemoryNumber
属性允许使用更大的值。
实现
public static function get totalMemory():uint
相关 API 元素
totalMemoryNumber | 属性 |
totalMemoryNumber:Number
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10.1, AIR 2 |
当前正使用的由 Flash Player 或 AIR 直接分配的内存量(以字节表示)。
此属性表示为数字,允许使用比 System.totalMemory
属性(其类型为 int)更高的值。
此属性不返回由 Adobe AIR 应用程序或包含 Flash Player 内容的应用程序(如浏览器)使用的所有内存。浏览器或操作系统可能使用其他内存。System.privateMemory
属性反映应用程序所使用的所有内存。
实现
public static function get totalMemoryNumber():Number
相关 API 元素
useCodePage | 属性 |
useCodePage:Boolean
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
一个布尔值,它决定使用哪个代码页来解释外部文本文件。当此属性设置为 false
时,会将外部文本文件解释为 Unicode。(保存这些文件时,必须使用 Unicode 对其进行编码。)当此属性设置为 true
时,将使用运行该应用程序的操作系统的传统代码页来解释外部文本文件。useCodePage
的默认值是 false
。
作为外部文件加载(使用 Loader.load()
、URLLoader 类或 URLStream)的文本必须已保存为 Unicode 格式,这样应用程序才能将它识别为 Unicode。要使用 Unicode 对外部文件进行编码,请在支持 Unicode 的应用程序(例如,Windows 上的“记事本”)中保存这些文件。
如果加载的外部文本文件不是 Unicode 编码格式,则应将 useCodePage
设置为 true
。将以下内容添加为正在加载数据的文件的第一行代码(对于 Flash Professional,将其添加到第一帧):
System.useCodePage = true;
如果存在此代码,则应用程序将使用操作系统的传统代码页来解释外部文本。例如,对于英文 Windows 操作系统,这通常为 CP1252,而对于日语操作系统,这通常为 Shift-JIS。
如果将 useCodePage
设置为 true
,则 Flash Player 6 及更高版本处理文本的方式与 Flash Player 5 相同。(Flash Player 5 将所有文本都视为使用运行播放器的操作系统的传统代码页显示文本。)
如果将 useCodePage
设置为 true
,则请记住,运行应用程序的操作系统的传统代码页必须包括外部文本文件中使用的字符,这样才能显示文本。例如,如果您加载了一个包含中文字符的外部文本文件,则这些字符不能显示在使用 CP1252 代码页的系统上,因为该代码页不包括中文字符。
为确保所有平台上的用户都能查看您的应用程序中使用的外部文本文件,应将所有外部文本文件按 Unicode 进行编码,并保留 useCodePage
的 false
设置。这样,应用程序(Flash Player 6 和更高版本或 AIR)会将文本解释为 Unicode。
实现
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void
相关 API 元素
disposeXML | () | 方法 |
exit | () | 方法 |
gc | () | 方法 |
public static function gc():void
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
强制执行垃圾回收进程。
仅限于 Flash Player 调试版和 AIR 应用程序。在 AIR 应用程序中,System.gc()
方法仅限在运行于 AIR Debug Launcher (ADL) 中的内容或已安装的应用程序的应用程序安全沙箱中的内容中启用。
pause | () | 方法 |
pauseForGCIfCollectionImminent | () | 方法 |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 11, AIR 3 |
如果垃圾回收器的临界值超过函数的临界参数,则建议回收器应完成增量回收循环。
在标记使用的内存时,Flash 运行时垃圾回收器算法将增量运行。当回收内存的未使用部分时,该算法将暂停应用程序的执行。在增量回收循环完成时发生的暂停可能比需要的时间长,并在某些程序中可以观察到或听到。应用程序可以使用此函数建议运行时完成标记并执行回收的理想时间。将潜在的暂停时间长度安排为不会引起用户注意的时间长度,这样可以提供更好的用户体验。例如,游戏在完成某个级别时可能会调用此函数,从而减少在游戏进行过程中发生暂停的次数。
临界值定义为距离回收器设定标记还有多远,即距离触发回收暂停还有多远。此函数的临界值参数是一个阈值:仅当实际临界值超出阈值时才调用垃圾回收器。否则,此调用将立即返回,不采取任何操作。
通过使用较低的临界值调用此函数,应用程序表示其愿意接受必须完成相对大量的标记。另一方面,较高的临界值表示仅当标记几乎完成时才应暂停应用程序。通常,前一种情况下的暂停时间比后一种情况下的暂停时间要长。
所释放的内存量不取决于临界参数。其仅取决于可释放对象的数量。如果应用程序最近释放了对较大数据结构或大量对象的引用,则较低的临界参数将容易触发一个将立即释放这些对象的集合。
参数
imminence:Number (default = 0.75 ) — 一个介于 0 和 1 之间的数字,其中 0 表示不紧急,1 表示最紧急。小于 0 的值默认为 0.25。大于 1.0 的值默认为 1.0。NaN 默认为 0.75
|
resume | () | 方法 |
setClipboard | () | 方法 |
public static function setClipboard(string:String):void
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9 |
用指定的文本字符串替换剪贴板的内容。当作为用户事件(例如键盘或输入设备事件处理函数)的结果调用此方法时,此方法可以在任何安全性上下文使用。
此方法是为 Flash Player 9 中运行的 SWF 内容提供的。它只允许向剪贴板添加 String 内容。
在 AIR 应用程序中,Flash Player 10 内容和应用程序安全沙箱中的内容可以调用 Clipboard.setData()
方法。
参数
string:String — 要放置在系统剪贴板上的纯文本字符串,用于替换系统剪贴板上的当前内容(如果有)。
|
相关 API 元素
System.setClipboard()
方法的调用中使用对 System.totalMemory
的调用,将有关系统的总内存的信息复制到系统剪贴板。
package { import flash.display.Sprite; import flash.system.System; public class SystemExample extends Sprite { public function SystemExample() { System.setClipboard("System.totalMemory: " + System.totalMemory); } } }
Tue Jun 12 2018, 11:04 AM Z