Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Класс Capabilities содержит свойства, которые описывают систему и проигрыватель, в которых воспроизводится SWF-файл. Например, экран мобильного телефона может составлять 100 квадратных пикселов (черно-белых), в то время как экран ПК будет 1000 квадратных пикселов (цветных). Используя объект Capabilities для определения типа устройства пользователя, можно предоставлять соответствующее содержимое максимально возможному количеству пользователей. Если известны возможности устройства, можно указать серверу подходящие SWF-файлы для отправки или задать смену презентации для SWF-файла.
Информацию о возможностях, которая хранится в свойстве 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
В следующей таблице перечислены свойства класса Capabilities и соответствующие строки сервера.
Свойство класса Capabilities | Строка сервера |
---|
avHardwareDisable
|
AVD
|
hasAccessibility
|
ACC
|
hasAudio
|
А
|
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 доступны только для чтения.
Посмотреть примеры
avHardwareDisable:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, был ли запрещен администратором доступ к камере и микрофону пользователя (значение true
) или нет (значение false
). Строка сервера AVD
.
В Adobe AIR™ это свойство применяется только к содержимому, находящемуся за пределами изолированной программной среды приложения. Содержимое, находящееся в изолированной программной среде приложения, может всегда обращаться к камере и микрофону пользователя.
Реализация public static function get avHardwareDisable():Boolean
См. также
hasAccessibility:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, поддерживает система связь со средствами для обеспечения специальных возможностей (true
) или нет (false
). Строка сервера ACC
.
Реализация public static function get hasAccessibility():Boolean
См. также
hasAudio:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, поддерживает ли система воспроизведение аудио. Для этого свойства всегда установлено значениеtrue
. Строка сервера A
.
Реализация public static function get hasAudio():Boolean
hasAudioEncoder:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, может ли система кодировать аудиопотоки, например данные с микрофона (true
), или нет (false
). Строка сервера AE
.
Реализация public static function get hasAudioEncoder():Boolean
hasColorCorrection:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10 |
Указывает, поддерживает ли операционная система коррекцию цвета и может ли Flash Player или AIR считать и распознать цветовой профиль главного (основного) монитора. Это свойство должно иметь значение true
, если требуется определить, может ли текущая система отображать информацию о коррекции цвета (enableColorCorrection=true
). Свойство hasColorCorrection
применяется только к главному монитору. Цветовой профиль главного монитора возвращается независимо от того, на каком мониторе в данный момент отображается SWF-файл.
Реализация public static function get hasColorCorrection():Boolean
См. также
hasEmbeddedVideo:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, поддерживает система внедренное видео (true
) или нет (false
). Строка сервера EV
.
Реализация public static function get hasEmbeddedVideo():Boolean
hasIME:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, установлен в системе редактор метода ввода (IME) (true
) или нет (false
). Строка сервера IME
.
Реализация public static function get hasIME():Boolean
См. также
hasMP3:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, имеет система декодер МР3 (true
) или нет (false
). Строка сервера MP3
.
Реализация public static function get hasMP3():Boolean
hasPrinting:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает, поддерживает система печать (true
) или нет (false
). Строка сервера PR
.
Реализация public static function get hasPrinting():Boolean
hasScreenBroadcast:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, поддерживает система разработку приложений видеотрансляции для работы через Flash Media Server (true
) или нет (false
). Строка сервера SB
.
Реализация public static function get hasScreenBroadcast():Boolean
hasScreenPlayback:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, поддерживает система воспроизведение приложений видеотрансляции, выполняемых через Flash Media Server (true
) или нет (false
). Строка сервера SP
.
Реализация public static function get hasScreenPlayback():Boolean
hasStreamingAudio:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, поддерживает система воспроизведение потокового аудио (true
) или нет (false
). Строка сервера SA
.
Реализация public static function get hasStreamingAudio():Boolean
hasStreamingVideo:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, поддерживает система воспроизведение потокового видео (true
) или нет (false
). Строка сервера SV
.
Реализация public static function get hasStreamingVideo():Boolean
hasTLS:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, поддерживает система собственные сокеты SSL через NetConnection (true
) или нет (false
). Строка сервера TLS
.
Реализация public static function get hasTLS():Boolean
См. также
hasVideoEncoder:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, может система кодировать видеопотоки, например данные с веб-камеры (true
), или нет (false
). Строка сервера VE
.
Реализация public static function get hasVideoEncoder():Boolean
isDebugger:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, использует система специальную отладочную программу (true
) или официально выпущенную версию (false
). Строка сервера DEB
. Это свойство имеет значение true
, когда работает отладочная версия Flash Player или AIR Debug Launcher (ADL).
Реализация public static function get isDebugger():Boolean
isEmbeddedInAcrobat:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 9.0.127.0, AIR 1.1 |
Указывает, в какой версии Acrobat открывается PDF-файл, в который встроен проигрыватель в PDF-файл: в Acrobat 9.0 или более поздней (true
) или нет (false
).
Реализация public static function get isEmbeddedInAcrobat():Boolean
language:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает код языка системы, в которой запущено содержимое. Язык указан как строчная двухсимвольная кодировка ISO 639-1. Для китайского языка предусмотрена дополнительная двухсимвольная национальная кодировка верхнего регистра из ISO 3166, различающая упрощенный и традиционный китайский языки. Обозначения кодировок основаны на английских названиях соответствующих языков, например: hu
обозначает венгерский язык (Hungarian).
В системах на английском языке это свойство возвращает только код языка (en
), но не код страны. В системах Microsoft Windows это свойство возвращает значение для языка интерфейса пользователя (UI), указывающее, какой язык используется во всех меню, диалоговых окнах, сообщениях об ошибках и файлах справки. В следующей таблице перечислены возможные значения.
Язык | Значение |
---|
Чешский | cs |
Датский | da |
Голландский | nl |
English | en |
Финский | fi |
Французский | fr |
Немецкий | de |
Венгерский | hu |
Итальянский | it |
Японский | ja |
Корейский | ko |
Норвежский | no |
Другой/неизвестен | xu |
Польский | pl |
Португальский | pt |
Русский | ru |
Китайский (упрощенный) | zh-CN |
Испанский | es |
Шведский | sv |
Китайский (традиционный) | zh-TW |
Турецкий | tr |
Примечание. Свойство Capabilities.language
может иметь только те значения, которые перечислены в списке. Вследствие этого ограничения, приложения Adobe AIR должны использовать первый элемент в массиве Capabilities.languages
для определения основного языка пользовательского интерфейса в системе.
Строка сервера L
.
Реализация public static function get language():String
См. также
Пример В следующем примере отображаемое содержимое зависит от языка операционной системы пользователя.
В свойстве 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:Array
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.1 |
Массив строк, содержащий сведения о предпочитаемых языках пользователя, заданных в операционной системе. Строки будут содержать теги языков (а также, где это применимо, сведения о сценарии и регионе), определенные в RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) и будут использовать дефисы в качестве разделителей (например, "en-US"
или "ja-JP"
). Языки перечисляются в массиве в порядке предпочтения, в соответствии с параметрами операционной системы. Первая запись в возвращенном массиве будет иметь тот же идентификатор основного языка, что и свойство language
. Например, если languages[0]
имеет значение "en-US"
, то свойство language
имеет значение "en"
. Однако, если свойство language
имеет значение "xu"
(указывающее неизвестный язык), то первый элемент в этом массиве будет другим.
Строка сервера LS
.
Реализация public static function get languages():Array
localFileReadDisable:Boolean
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает, был ли запрещен администратором доступ к жесткому диску пользователя (значение true
) или нет (значение false
). В Adobe AIR это свойство применяется только к содержимому, находящемуся за пределами изолированной программной среды приложения. (Содержимое в изолированной программной среде приложения всегда может считывать данные в файловой системе.) Если для этого свойства установлено значение true
, проигрыватель Flash Player не может читать файлы (включая первый файл, с которым запускается проигрыватель Flash Player) с жесткого диска пользователя. Если это свойство имеет значение true
, содержимое AIR, находящееся за пределами изолированной программной среды приложения, не может считывать файлы с локального жесткого диска. Например, попытки прочитать файл на жестком диске пользователя с помощью методов загрузки завершаться ошибкой, если для этого свойства задано значение true
.
Чтение общих во время выполнения библиотек также блокируется, если для этого свойства установлено значение true
, но чтение локальных общих библиотек разрешено независимо от значения этого свойства.
Строка сервера LFD
.
Реализация public static function get localFileReadDisable():Boolean
См. также
manufacturer:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает производителя работающей версии Flash Player или среды выполнения AIR в формате "Adobe
OSName"
. Значением для OSName
могут быть Windows
, Macintosh
, Linux
или название другой операционной системы. Строка сервера M
.
Реализация public static function get manufacturer():String
os:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает текущую операционную систему. Свойство os
может возвращать следующие строки: "Windows XP"
, "Windows 2000"
, "Windows NT"
, "Windows 98/ME"
, "Windows 95"
, "Windows CE"
(доступно только в Flash Player SDK, а в версии для ПК — нет), "Linux"
и "Mac OS X.Y.Z"
(где X.Y.Z — это номер версии, например Mac OS 10.5.2
). Строка сервера OS
.
Реализация public static function get os():String
pixelAspectRatio:Number
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает соотношение сторон экрана в пикселах. Строка сервера AR
.
Реализация public static function get pixelAspectRatio():Number
playerType:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Указывает тип среды выполнения. Это свойство может иметь одно из следующих значений.
StandAlone
для автономного проигрывателя Flash PlayerExternal
для внешнего проигрывателя Flash PlayerPlugIn
для встраиваемого в обозреватель модуля проигрывателя Flash PlayerActiveX
для управляющего элемента ActiveX с проигрывателем Flash Player, используемого в Microsoft Internet Explorer"Desktop"
для среды выполнения Adobe AIR (за исключением SWF-содержимого, загруженного HTML-страницей, со свойством Capabilities.playerType
в значении "PlugIn"
)External
для внешнего проигрывателя Flash PlayerPlugIn
для встраиваемого в обозреватель модуля проигрывателя Flash Player (и для SWF-содержимого, загруженного HTML-страницей в приложении AIR)StandAlone
для автономного проигрывателя Flash Player
Строка сервера PT
.
Реализация public static function get playerType():String
screenColor:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает цвет экрана. Это свойство может иметь значение color
, gray
(для изображения в оттенках серого) или bw
(для черно-белого изображения). Строка сервера COL
.
Реализация public static function get screenColor():String
screenDPI:Number
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает разрешение "dpi" (точек на дюйм) экрана в пикселах. Строка сервера DP
.
Реализация public static function get screenDPI():Number
screenResolutionX:Number
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает максимальное разрешение экрана по горизонтали. Строка сервера R
(возвращает значения как для ширины, так и для высоты экрана). Это свойство не обновляется пользовательским значением разрешения экрана, а только показывает разрешение в момент запуска проигрывателя Flash Player или приложения Adobe AIR. Кроме того, это значение указывает характеристики только для основного монитора.
Реализация public static function get screenResolutionX():Number
screenResolutionY:Number
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает максимальное разрешение экрана по вертикали. Строка сервера R
(возвращает значения как для ширины, так и для высоты экрана). Это свойство не обновляется пользовательским значением разрешения экрана, а только показывает разрешение в момент запуска проигрывателя Flash Player или приложения Adobe AIR. Кроме того, это значение указывает характеристики только для основного монитора.
Реализация public static function get screenResolutionY():Number
serverString:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, 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
version:String
[только для чтения]
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Показывает сведения о платформе и версии Flash Player или Adobe® AIR. Номер версии имеет следующий формат: platform majorVersion, minorVersion, buildNumber, internalBuildNumber. Возможными значениями для platform являются 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
В следующем примере просто приведены значения, обнаруженные в объекте flash.system.Capabilities с помощью нескольких вызовов
trace()
.
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);
}
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Wed Sep 24 2008, 07:56 AM -07:00