Capabilities  - AS3

Показывает, был ли запрещен администратором доступ к камере и микрофону пользователя (значение true) или нет (значение false). Строка сервера AVD.

В Adobe AIR™ это свойство применяется только к содержимому, находящемуся за пределами изолированной программной среды приложения. Содержимое, находящееся в изолированной программной среде приложения, может всегда обращаться к камере и микрофону пользователя.

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

Определяет текущую архитектуру центрального процессора. Свойство cpuArchitecture может возвратить следующие строки: PowerPC, x86, SPARC и ARM. Строка сервера ARCH.

Указывает, поддерживает ли система связь со средствами для обеспечения специальных возможностей (true) или нет (false). Строка сервера ACC.

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

Указывает, поддерживает ли система воспроизведение аудио. Для этого свойства всегда установлено значениеtrue. Строка сервера A.

Показывает, может ли система кодировать аудиопотоки, например данные с микрофона (true), или нет (false). Строка сервера AE.

Указывает, поддерживает ли система внедренное видео (true) или нет (false). Строка сервера EV.

Указывает, установлен ли в системе редактор метода ввода (IME) (true) или нет (false). Строка сервера IME.

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

Указывает, имеет ли система декодер МР3 (true) или нет (false). Строка сервера MP3.

Указывает, поддерживает ли система печать (true) или нет (false). Строка сервера PR.

Показывает, поддерживает ли система разработку приложений видеотрансляции для работы через Flash Media Server (true) или нет (false). Строка сервера SB.

Показывает, поддерживает ли система воспроизведение приложений видеотрансляции, выполняемых через Flash Media Server (true) или нет (false). Строка сервера SP.

Показывает, поддерживает ли система воспроизведение потокового аудио (true) или нет (false). Строка сервера SA.

Показывает, поддерживает ли система воспроизведение потокового видео (true) или нет (false). Строка сервера SV.

Показывает, поддерживает ли система собственные сокеты SSL через NetConnection (true) или нет (false). Строка сервера TLS.

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

Показывает, способна ли система кодировать видеопотоки, например данные с web-камеры (true), или нет (false). Строка сервера VE.

Показывает, является ли система специальной отладочной версией (true) или официально выпущенной версией (false). Строка сервера DEB. Это свойство имеет значение true, когда работает отладочная версия Flash Player или AIR Debug Launcher (ADL).

Указывает, в какой версии среды выполнения Flash открывается PDF-файл, в который встроен проигрыватель в PDF-файл: в Acrobat 9.0 или более поздней (true) или нет (false).

Указывает код языка системы, в которой запущено содержимое. Язык указан как строчная двухсимвольная кодировка ISO 639-1. Для китайского языка предусмотрена дополнительная двухсимвольная национальная кодировка верхнего регистра из ISO 3166, различающая упрощенный и традиционный китайский языки. Обозначения кодировок основаны на английских названиях соответствующих языков, например: hu обозначает венгерский язык (Hungarian).

В системах на английском языке это свойство возвращает только код языка (en), но не код страны. В системах Microsoft Windows это свойство возвращает значение для языка интерфейса пользователя (UI), указывающее, какой язык используется во всех меню, диалоговых окнах, сообщениях об ошибках и файлах справки. В следующей таблице перечислены возможные значения.

Примечание. Свойство Capabilities.language может иметь только те значения, которые перечислены в списке. Вследствие этого ограничения приложения Adobe AIR должны использовать первый элемент в массиве Capabilities.languages для определения основного языка пользовательского интерфейса в системе.

Строка сервера L.

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

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);
        }
    }
}

Массив строк, содержащий сведения о предпочитаемых языках пользовательского интерфейса, заданных в операционной системе. Строки будут содержать теги языков (а также, где это применимо, сведения о сценарии и регионе), определенные в 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.

Показывает, был ли запрещен администратором доступ к жесткому диску пользователя (значение true) или нет (значение false). В Adobe AIR это свойство применяется только к содержимому, находящемуся за пределами изолированной программной среды приложения. (Содержимое в изолированной программной среде приложения всегда может считывать данные в файловой системе.) Если для этого свойства установлено значение true, проигрыватель Flash Player не может читать файлы (включая первый файл, с которым запускается проигрыватель Flash Player) с жесткого диска пользователя. Если это свойство имеет значение true, содержимое AIR, находящееся за пределами изолированной программной среды приложения, не может считывать файлы с локального жесткого диска. Например, попытки прочитать файл на жестком диске пользователя с помощью методов загрузки завершаться ошибкой, если для этого свойства задано значение true.

Чтение общих во время выполнения библиотек также блокируется, если для этого свойства установлено значение true, но чтение локальных общих библиотек разрешено независимо от значения этого свойства.

Строка сервера LFD.

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

Указывает производителя работающей версии Flash Player или среды выполнения AIR в формате «Adobe OSName». Значением для OSName могут быть Windows, Macintosh, Linux или название другой операционной системы. Строка сервера M.

Не используйте Capabilities.manufacturer для определения возможности на основе операционной системы, если существует более конкретное свойство, соответствующее возможности. Создание функций на основе одной операционной системы не рекомендуется, так как это может привести к проблемам, если в приложении не рассмотрены все потенциальные целевые операционные системы. Вместо этого используйте свойство, соответствующее функции, для которой выполняется тестирование. Дополнительные сведения см. в описании класса Capabilities.

Извлечение самого высокого уровня IDC H.264, поддерживаемого оборудованием клиента. На этом уровне носитель будет гарантированно запущен; однако носитель, запущенный на более высоком уровне, может выполняться с более низким качеством. Это свойство необходимо для серверов, на которых предпринимается попытка получения сведений о возможностях клиента. С помощью этого свойства сервер может определить уровень видео, переданного клиенту.

Серверной строкой является ML.

Указывает текущую операционную систему. Свойство os может возвращать следующие строки:

Строка сервера OS.

Не используйте Capabilities.os для определения возможности на основе операционной системы, если существует более конкретное свойство, соответствующее функции. Создание функций на основе одной операционной системы не рекомендуется, так как это может привести к проблемам, если в приложении не рассмотрены все потенциальные целевые операционные системы. Вместо этого используйте свойство, соответствующее функции, для которой выполняется тестирование. Дополнительные сведения см. в описании класса Capabilities.

Задает пропорции экрана в пикселях. Строка сервера AR.

Указывает тип среды выполнения. Это свойство может иметь одно из следующих значений.

• ActiveX для управляющего элемента ActiveX с проигрывателем Flash Player, используемого в Microsoft Internet Explorer
• Desktop для среды выполнения Adobe AIR (за исключением SWF-содержимого, загруженного HTML-страницей, со свойством Capabilities.playerType в значении PlugIn)
• External для внешнего проигрывателя Flash Player или для работы в режиме тестирования
• PlugIn для внешнего модуля браузера Flash Player (и для SWF-содержимого, загруженного HTML-страницей в приложении AIR)
• StandAlone для автономного проигрывателя Flash Player

Строка сервера PT.

Задает цвет экрана. Это свойство может иметь значение color, gray (для изображения в оттенках серого) или bw (для черно-белого изображения). Строка сервера COL.

Задает разрешение dpi (точек на дюйм) экрана в пикселях. Строка сервера DP.

Задает максимальное разрешение экрана по горизонтали. Строка сервера R (возвращает значения как для ширины, так и для высоты экрана). Это свойство не обновляется пользовательским значением разрешения экрана, а только показывает разрешение в момент запуска проигрывателя Flash Player или приложения Adobe AIR. Кроме того, это значение указывает характеристики только для основного экрана.

Задает максимальное разрешение экрана по вертикали. Строка сервера R (возвращает значения как для ширины, так и для высоты экрана). Это свойство не обновляется пользовательским значением разрешения экрана, а только показывает разрешение в момент запуска проигрывателя Flash Player или приложения Adobe AIR. Кроме того, это значение указывает характеристики только для основного экрана.

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;
}

Строка в кодировке 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

Показывает, поддерживает ли система выполнение 32-разрядных процессов. Строка сервера PR32.

Показывает, поддерживает ли система выполнение 64-разрядных процессов. Строка сервера PR64.

Определяет тип поддерживаемого сенсорного экрана, если он имеется. Значения определяются в классе flash.system.TouchscreenType.

Связанные элементы 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;
}

Показывает сведения о платформе и версии 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.

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;
}

Указывает, поддерживает ли система многоканальное аудио определенного типа. Класс 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 рекомендуется предусмотреть интерфейс, чтобы пользователь мог сообщить, что отсутствует звук. В таком случае приложение может переключиться на другой кодек.

В следующей таблице показана строка сервера для каждого типа многоканального аудио.

Параметры

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

    trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);