| Пакет | flash.system |
| Класс | public final class Capabilities |
| Наследование | Capabilities  Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Однако некоторые возможности Adobe AIR не обеспечиваются свойствами класса Capabilities. Они являются свойствами других классов:
| Свойство | Описание |
|---|---|
NativeApplication.supportsDockIcon
| Наличие в операционной системе поддержки значков приложения на панели Dock. |
NativeApplication.supportsMenu
| Наличие в операционной системе поддержки глобальных строк меню приложений. |
NativeApplication.supportsSystemTrayIcon
| Наличие в операционной системе поддержки значков на панели задач. |
NativeWindow.supportsMenu
| Наличие в операционной системе поддержки оконных меню. |
NativeWindow.supportsTransparency
| Наличие в операционной системе поддержки прозрачных окон. |
Не используйте Capabilities.os или Capabilities.manufacturer для определения возможности на основе операционной системы. Создание функций на основе одной операционной системы не рекомендуется, так как это может привести к проблемам, если в приложении не рассмотрены все потенциальные целевые операционные системы. Вместо этого используйте свойство, соответствующее функции, для которой выполняется тестирование.
Информацию о возможностях, которая хранится в свойстве Capabilities.serverString в виде URL-строки, можно отправить с помощью HTTP-методов GET или POST. В следующем примере показана строка сервера для компьютера с поддержкой 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&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 | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| cpuArchitecture : String [статические] [только для чтения]
Определяет текущую архитектуру центрального процессора. | 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 [статические] [только для чтения]
Указывает, имеет ли система декодер МР3 (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 [статические] [только для чтения]
Показывает, поддерживает ли система собственные сокеты SSL через NetConnection (true) или нет (false). | Capabilities | ||
| hasVideoEncoder : Boolean [статические] [только для чтения]
Показывает, способна ли система кодировать видеопотоки, например данные с web-камеры (true), или нет (false). | Capabilities | ||
| isDebugger : Boolean [статические] [только для чтения]
Показывает, является ли система специальной отладочной версией (true) или официально выпущенной версией (false). | Capabilities | ||
| isEmbeddedInAcrobat : Boolean [статические] [только для чтения]
Указывает, в какой версии среды выполнения Flash открывается PDF-файл, в который встроен проигрыватель в PDF-файл: в Acrobat 9.0 или более поздней (true) или нет (false). | Capabilities | ||
| language : String [статические] [только для чтения]
Указывает код языка системы, в которой запущено содержимое. | Capabilities | ||
| languages : Array [статические] [только для чтения]
Массив строк, содержащий сведения о предпочитаемых языках пользовательского интерфейса, заданных в операционной системе. | Capabilities | ||
| localFileReadDisable : Boolean [статические] [только для чтения]
Показывает, был ли запрещен администратором доступ к жесткому диску пользователя (значение true) или нет (значение false). | Capabilities | ||
| manufacturer : String [статические] [только для чтения]
Указывает производителя работающей версии Flash Player или среды выполнения AIR в формате «Adobe OSName». | Capabilities | ||
| maxLevelIDC : String [статические] [только для чтения]
Извлечение самого высокого уровня IDC H.264, поддерживаемого оборудованием клиента. | Capabilities | ||
| os : String [статические] [только для чтения]
Указывает текущую операционную систему. | Capabilities | ||
| pixelAspectRatio : Number [статические] [только для чтения]
Задает пропорции экрана в пикселях. | Capabilities | ||
| playerType : String [статические] [только для чтения]
Указывает тип среды выполнения. | Capabilities | ||
| screenColor : String [статические] [только для чтения]
Задает цвет экрана. | Capabilities | ||
| screenDPI : Number [статические] [только для чтения]
Задает разрешение dpi (точек на дюйм) экрана в пикселях. | Capabilities | ||
| screenResolutionX : Number [статические] [только для чтения]
Задает максимальное разрешение экрана по горизонтали. | Capabilities | ||
| screenResolutionY : Number [статические] [только для чтения]
Задает максимальное разрешение экрана по вертикали. | Capabilities | ||
| serverString : String [статические] [только для чтения]
Строка в кодировке URL, задающая значения для каждого свойства Capabilities. | Capabilities | ||
| supports32BitProcesses : Boolean [статические] [только для чтения]
Показывает, поддерживает ли система выполнение 32-разрядных процессов. | Capabilities | ||
| supports64BitProcesses : Boolean [статические] [только для чтения]
Показывает, поддерживает ли система выполнение 64-разрядных процессов. | Capabilities | ||
| touchscreenType : String [статические] [только для чтения]
Определяет тип поддерживаемого сенсорного экрана, если он имеется. | Capabilities | ||
| version : String [статические] [только для чтения]
Показывает сведения о платформе и версии Flash Player или Adobe® AIR®. | Capabilities | ||
| Метод | Определено | ||
|---|---|---|---|
[статические]
Указывает, поддерживает ли система многоканальное аудио определенного типа. | Capabilities | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | 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 |
Определяет текущую архитектуру центрального процессора. Свойство cpuArchitecture может возвратить следующие строки: PowerPC, x86, SPARC и ARM. Строка сервера ARCH.
Реализация
public static function get cpuArchitecture():StringhasAccessibility | свойство |
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():BooleanhasAudioEncoder | свойство |
hasAudioEncoder:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Показывает, может ли система кодировать аудиопотоки, например данные с микрофона (true), или нет (false). Строка сервера AE.
Реализация
public static function get hasAudioEncoder():BooleanhasEmbeddedVideo | свойство |
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 | свойство |
hasPrinting | свойство |
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():BooleanhasScreenPlayback | свойство |
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():BooleanhasStreamingAudio | свойство |
hasStreamingAudio:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Показывает, поддерживает ли система воспроизведение потокового аудио (true) или нет (false). Строка сервера SA.
Реализация
public static function get hasStreamingAudio():BooleanhasStreamingVideo | свойство |
hasStreamingVideo:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Показывает, поддерживает ли система воспроизведение потокового видео (true) или нет (false). Строка сервера SV.
Реализация
public static function get hasStreamingVideo():BooleanhasTLS | свойство |
hasTLS:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Показывает, поддерживает ли система собственные сокеты SSL через NetConnection (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():BooleanisDebugger | свойство |
isDebugger:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Показывает, является ли система специальной отладочной версией (true) или официально выпущенной версией (false). Строка сервера DEB. Это свойство имеет значение true, когда работает отладочная версия Flash Player или AIR Debug Launcher (ADL).
Реализация
public static function get isDebugger():BooleanisEmbeddedInAcrobat | свойство |
isEmbeddedInAcrobat:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9.0.127.0, AIR 1.1, Flash Lite 4 |
Указывает, в какой версии среды выполнения Flash открывается PDF-файл, в который встроен проигрыватель в PDF-файл: в Acrobat 9.0 или более поздней (true) или нет (false).
Реализация
public static function get isEmbeddedInAcrobat():Booleanlanguage | свойство |
language:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Указывает код языка системы, в которой запущено содержимое. Язык указан как строчная двухсимвольная кодировка ISO 639-1. Для китайского языка предусмотрена дополнительная двухсимвольная национальная кодировка верхнего регистра из ISO 3166, различающая упрощенный и традиционный китайский языки. Обозначения кодировок основаны на английских названиях соответствующих языков, например: hu обозначает венгерский язык (Hungarian).
В системах на английском языке это свойство возвращает только код языка (en), но не код страны. В системах Microsoft Windows это свойство возвращает значение для языка интерфейса пользователя (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. Например, если Capabilities.languages[0] имеет значение en-US, то свойство language имеет значение en. Однако, если свойство Capabilities.language имеет значение xu (указывающее неизвестный язык), то первый элемент в этом массиве будет другим. В связи с этим Capabilities.languages[0] может указывать более точную информацию, чем Capabilities.language.
Строка сервера LS.
Реализация
public static function get languages():ArraylocalFileReadDisable | свойство |
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():StringmaxLevelIDC | свойство |
maxLevelIDC:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Извлечение самого высокого уровня IDC H.264, поддерживаемого оборудованием клиента. На этом уровне носитель будет гарантированно запущен; однако носитель, запущенный на более высоком уровне, может выполняться с более низким качеством. Это свойство необходимо для серверов, на которых предпринимается попытка получения сведений о возможностях клиента. С помощью этого свойства сервер может определить уровень видео, переданного клиенту.
Серверной строкой является ML.
Реализация
public static function get maxLevelIDC():Stringos | свойство |
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():StringpixelAspectRatio | свойство |
playerType | свойство |
playerType:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Указывает тип среды выполнения. Это свойство может иметь одно из следующих значений.
ActiveXдля управляющего элемента ActiveX с проигрывателем Flash Player, используемого в Microsoft Internet ExplorerDesktopдля среды выполнения Adobe AIR (за исключением SWF-содержимого, загруженного HTML-страницей, со свойствомCapabilities.playerTypeв значенииPlugIn)Externalдля внешнего проигрывателя Flash Player или для работы в режиме тестированияPlugInдля внешнего модуля браузера Flash Player (и для SWF-содержимого, загруженного HTML-страницей в приложении AIR)StandAloneдля автономного проигрывателя Flash Player
Строка сервера PT.
Реализация
public static function get playerType():StringscreenColor | свойство |
screenColor:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает цвет экрана. Это свойство может иметь значение color, gray (для изображения в оттенках серого) или bw (для черно-белого изображения). Строка сервера COL.
Реализация
public static function get screenColor():StringscreenDPI | свойство |
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():NumberscreenResolutionY | свойство |
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 |
Строка в кодировке 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():Stringsupports32BitProcesses | свойство |
supports64BitProcesses | свойство |
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 не воспроизводится. В качестве примера рассмотрим проигрыватель Blu-ray с выходом S/PDIF, подключенный к старому усилителю. Старый усилитель не поддерживает DTS, а у выхода S/PDIF нет протокола для уведомления проигрывателя Blu-ray об этой ситуации. Если проигрыватель Blu-ray отправляет поток DTS старому усилителю, пользователь ничего не слышит. Поэтому при использовании DTS рекомендуется предусмотреть интерфейс, чтобы пользователь мог сообщить, что отсутствует звук. В таком случае приложение может переключиться на другой кодек.
В следующей таблице показана строка сервера для каждого типа многоканального аудио.
| Тип многоканального аудио | Строка сервера |
|---|---|
AudioDecoder.DOLBY_DIGITAL | DD |
AudioDecoder.DOLBY_DIGITAL_PLUS | DDP |
AudioDecoder.DTS | DTS |
AudioDecoder.DTS_EXPRESS | DTE |
AudioDecoder.DTS_HD_HIGH_RESOLUTION_AUDIO | DTH |
AudioDecoder.DTS_HD_MASTER_AUDIO | DTM |
Параметры
type:String — Строковое значение, представляющее тип многоканального аудио. Допустимыми значениями являются константы, определенные в flash.media.AudioDecoder.
|
Boolean — Логическое значение true, если система поддерживает тип многоканального аудио, передаваемый в параметре type. В противном случае значение возвращается значение false.
|
Связанные элементы API
Пример ( Использование этого примера )
hasMultiChannelAudio(). Возвращенное значение указывает, поддерживает ли система многоканальное аудио Dolby Digital.
trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);
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);
}
}
}
Tue Jun 12 2018, 11:34 AM Z