System - Adobe ActionScript® 3 (AS3 )

Пакет	flash.system
Класс	public final class System
Наследование	System Object

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Класс System содержит свойства, связанные с локальными настройками и операциями. Сюда относятся настройки камер и микрофонов, операции с общими объектами и использование буфера обмена.

Дополнительные свойства и методы находятся в других классах пакета flash.system: класс Capabilities, класс IME и класс Security.

Этот класс содержит только статические методы и свойства. Невозможно создать новые экземпляры класса System.

Посмотреть примеры

Связанные элементы API

flash.system.Security
flash.events.IMEEvent

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		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 [статические] Значение типа Boolean, указывающее кодовую страницу, которую следует использовать для интерпретации внешних текстовых файлов.	System

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		disposeXML(node:XML):void [статические] Объект XML сразу же становится доступным для сборки мусора.	System
		exit(code:uint):void [статические] Закрывает проигрыватель Flash Player.	System
		gc():void [статические] Запускает процесс очистки.	System
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		pause():void [статические] Устанавливает паузу в работе Flash Player или AIR Debug Launcher (ADL).	System
		pauseForGCIfCollectionImminent(imminence:Number = 0.75):void [статические] Предлагает сборщику мусора завершения инкрементного цикла сборки, если превышено значение параметра приближения функции.	System
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		resume():void [статические] Возобновляет работу приложения после вызова метода System.pause().	System
		setClipboard(string:String):void [статические] Заменяет содержимое буфера обмена заданной текстовой строкой.	System
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Сведения о свойстве

freeMemory

свойство

freeMemory:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2

Объем памяти (в байтах), который выделен для Adobe^® Flash^® Player или Adobe^® AIR^® и не используется в данный момент. Эта неиспользованная часть выделенной памяти (System.totalMemory) меняется по мере «сбора мусора». Используйте это свойство для отслеживания «сбора мусора»

Реализация
public static function get freeMemory():Number

Связанные элементы API

privateMemory
totalMemory
totalMemoryNumber

ime

свойство

ime:IME [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Текущая установленная система IME. Чтобы подписаться на события imeComposition, вызовите addEventListener() для этого экземпляра.

Реализация
public static function get ime():IME

Связанные элементы API

IMEConversionMode

privateMemory

свойство

privateMemory:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2

Весь объем памяти (в байтах), используемый приложением. Это объем резидентной памяти всего процесса

Разработчикам AIR следует использовать это свойство для определения общего потребления памяти приложением.

Для Flash Player это значение включает память, используемую приложением-контейнером, например веб-браузером.

Реализация
public static function get privateMemory():Number

Связанные элементы API

freeMemory
totalMemory
totalMemoryNumber

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, или 4294967295), тогда это свойство получает значение 0. Свойство System.totalMemoryNumber допускает использование объема памяти, превышающего это значение.

Реализация
public static function get totalMemory():uint

Связанные элементы API

freeMemory
privateMemory
totalMemoryNumber

totalMemoryNumber

свойство

totalMemoryNumber:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 2

Используемый в данным момент объем памяти (в байтах), который выделен непосредственно средой Flash Player или AIR.

Это свойство представлено объектом Number, который позволяет использовать более высокие значения, чем свойство System.totalMemory, которое представлено целым числом.

Реализация
public static function get totalMemoryNumber():Number

Связанные элементы API

freeMemory
privateMemory
totalMemory

useCodePage

свойство

useCodePage:Boolean

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Значение типа Boolean, указывающее кодовую страницу, которую следует использовать для интерпретации внешних текстовых файлов. Если это свойство имеет значение false, при интерпретации внешних текстовых файлов используется кодировка Юникод. (Эти файлы должны быть в кодировке Юникод при сохранении.) Если для этого свойства задано значение true, внешние текстовые файлы интерпретируются с помощью стандартной кодовой страницы операционной системы, в которой выполняется приложение. По умолчанию для свойства useCodePage задано значение false.

Текст, загружаемый как внешний файл (с помощью Loader.load(), класса URLLoader или класса URLStream), должен быть сохранен в кодировке Юникод, чтобы приложение правильно распознало его. Чтобы изменить кодировку внешних файлов на Юникод, сохраните их в приложении, поддерживающем эту кодировку, например с помощью программы блокнот в Windows.

При загрузке внешних текстовых файлов, кодировка которых не Юникод, установите для свойства useCodePage значение true. Добавьте следующий фрагмент в качестве первой строки кода в файле, который загружает данные (для Flash Professional эту строку нужно добавить в первый кадр):

System.useCodePage = true;

Если имеется эта кодировка, приложение интерпретирует внешний текст с помощью стандартной кодовой страницы операционной системы. Например, это обычно бывает кодировка CP1252 для английской версии операционной системы Windows и Shift-JIS для японской операционной системы.

Если для свойства useCodePage установить значение true, в проигрывателе Flash Player 6 и более поздних версиях обрабатывают текст также, как проигрыватель Flash Player 5. (Проигрыватель Flash Player 5 обрабатывает все тексты таким образом, как если бы они все были в стандартной кодировке операционной системы, в которой запущен проигрыватель.)

Если для свойства useCodePage установлено значение true, помните, что стандартная кодовая страница операционной системы, в которой выполняется приложение, должна включать символы, используемые во внешнем текстовом файле, чтобы можно было отобразить данный текст. Например, если загружается внешний текстовый файл, содержащий китайские символы, эти символы невозможно отобразить в системе, где используется кодовая страница CP1252, поскольку она не содержит символов для китайского языка.

Чтобы обеспечить пользователям на всех платформах возможность просматривать внешние текстовые файлы, используемые в вашем приложении, необходимо использовать в этих текстовых файлах кодировку Юникод и оставить для свойства useCodePage значение false. Таким образом приложение (Flash Player 6 и более поздних версий или AIR) интерпретирует текст как Юникод.

Реализация
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void

Связанные элементы API

flash.display.Loader.load()

Сведения о методе

disposeXML

()

метод

public static function disposeXML(node:XML):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 10.1, AIR 1.5.2

Объект XML сразу же становится доступным для сборки мусора. С помощью этого метода удаляются родительские и дочерние соединения всех узлов указанного узла XML.

Параметры

node:XML — Ссылка XML, которую необходимо сделать доступной для сборки мусора.

exit

()

метод

public static function exit(code:uint):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.115.0

Закрывает проигрыватель Flash Player.

Только для отладочной версии проигрывателя Flash Player.

Чтобы выйти из приложения, приложения AIR должны вызвать метод NativeApplication.exit().

Параметры

code:uint — Значение, передаваемое в операционную систему. Обычно, если процесс нормально завершается, это значение равно 0.

Связанные элементы API

flash.desktop.NativeApplication.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

()

метод

public static function pause():void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Устанавливает паузу в работе Flash Player или AIR Debug Launcher (ADL). После вызова этого метода все операции приложения прекращаются, за исключением доставки событий Socket.

Только для отладочной версии Flash Player или AIR Debug Launcher (ADL).

Связанные элементы API

resume()

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

()

метод

public static function resume():void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Возобновляет работу приложения после вызова метода System.pause().

Только для отладочной версии Flash Player или AIR Debug Launcher (ADL).

Связанные элементы API

pause()

setClipboard

()

метод

public static function setClipboard(string:String):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9

Заменяет содержимое буфера обмена заданной текстовой строкой. Этот метод работает в любом контексте безопасности, если вызывается в результате пользовательского события (например, обработчика события клавиатуры или устройства ввода).

Этот метод доступен для SWF-содержимого, выполняемого во Flash Player 9. Он позволяет добавлять в буфер обмена только содержимое типа String.

Содержимое Flash Player 10 и содержимое в изолированной программной среде безопасности приложения AIR может вызывать метод Clipboard.setData().

Параметры

string:String — Состоящая из символов строка с обычным текстом для размещения в буфере обмена системы, замещая текущее содержимое (если есть).

Связанные элементы API

flash.desktop.Clipboard

Примеры Использование этого примера

SystemExample.as

В следующем примере показано, как информация об общем объеме памяти системы копируется в буфер обмена системы путем обращения к System.totalMemory при вызове метода System.setClipboard().

package {
    import flash.display.Sprite;
    import flash.system.System;

    public class SystemExample extends Sprite {
        public function SystemExample() {
            System.setClipboard("System.totalMemory: " + System.totalMemory);
        }
    }
}

Юридическая информация | Политика конфиденциальности онлайн

System - AS3

Пакетыx

Элементы языка

Приложения

Пакет flash.system

freeMemory

ime

privateMemory

totalMemory

totalMemoryNumber

useCodePage

disposeXML

exit

gc

pause

pauseForGCIfCollectionImminent

resume

setClipboard