Capabilities  - AS3

Specifica se l'accesso alla fotocamera e al microfono dell'utente è stato negato (true) o consentito (false) dall'amministratore. La stringa server è AVD.

Per il contenuto di Adobe AIR™, questa proprietà è applicabile unicamente al contenuto di sandbox di sicurezza diverse da quella dell'applicazione. Il contenuto della sandbox di sicurezza dell'applicazione può sempre accedere alla videocamera e al microfono dell'utente.

Elementi API correlati

Specifica l'architettura CPU corrente. La proprietà cpuArchitecture può restituire le seguenti stringhe: "PowerPC", "x86", "SPARC" e "ARM". La stringa server è ARCH.

Specifica se il sistema supporta (true) o meno (false) comunicazioni con strumenti di supporto all'accessibilità. La stringa server è ACC.

Elementi API correlati

Specifica se il sistema è dotato di funzionalità audio. Questa proprietà è sempre true. La stringa server è A.

Indica se il sistema è in grado (true) o meno (false) di codificare uno streaming audio (ad esempio, quello catturato da un microfono). La stringa server è AE.

Specifica se il sistema supporta (true) o meno (false) il video incorporato. La stringa server è EV.

Indica se il sistema presenta (true) o meno (false) un IME (Input Method Editor) installato. La stringa server è IME.

Altri esempi

Elementi API correlati

Specifica se il sistema presenta (true) o meno (false) un decodificatore MP3. La stringa server è MP3.

Altri esempi

Specifica se il sistema supporta (true) o meno (false) la stampa. La stringa server è PR.

Indica se il sistema supporta (true) o meno (false) lo sviluppo di applicazioni di trasmissione su schermo da eseguire mediante Flash Media Server. La stringa server è SB.

Indica se il sistema supporta (true) o meno (false) la riproduzione di applicazioni di trasmissione su schermo che vengono eseguite mediante Flash Media Server. La stringa server è SP.

Specifica se il sistema è in grado (true) o meno (false) di riprodurre lo streaming audio. La stringa server è SA.

Specifica se il sistema è in grado (true) o meno (false) di riprodurre lo streaming video. La stringa server è SV.

Indica se il sistema supporta (true) o meno (false) socket SSL nativi mediante NetConnection. La stringa server è TLS.

Elementi API correlati

Indica se il sistema è in grado (true) o meno (false) di codificare uno streaming video (ad esempio, quello proveniente da una webcam). La stringa server è VE.

Indica se il sistema è una speciale versione di debug (true), oppure una release ufficiale (false). La stringa server è DEB. Questa proprietà è impostata su true se in esecuzione sulla versione di debug di Flash Player o suAIR Debug Launcher (ADL).

Specifica se il runtime Flash è incorporato in un file PDF aperto in Acrobat 9.0 o versione successiva (true) o non è aperto (false).

Altri esempi

Indica il codice di lingua del sistema su cui è in esecuzione il contenuto. La lingua è specificata sotto forma di codice della lingua ISO 639-1 costituito da due lettere minuscole. Nel caso del cinese, un tag secondario del codice nazionale ISO 3166 a due lettere maiuscole distingue tra il cinese semplificato e quello tradizionale. I codici di lingua si basano sui nomi inglesi della lingua: Ad esempio, hu specifica l'ungherese.

Sui sistemi in lingua inglese, questa proprietà restituisce solo il codice della lingua (en), non il codice del Paese. Sui sistemi Microsoft Windows, questa proprietà restituisce la lingua dell'interfaccia utente (UI), che fa riferimento alla lingua utilizzata per tutti i menu, le finestre di dialogo, i messaggi di errore e i file della Guida in linea. Di seguito sono riportati i valori possibili:

Nota: il valore della proprietà Capabilities.language è limitato ai valori possibili presenti in questo elenco. A causa di questa limitazione, le applicazioni Adobe AIR devono utilizzare il primo elemento nell'array Capabilities.languages per determinare la lingua primaria dell'interfaccia utente del sistema.

La stringa server è L.

Altri esempi

Elementi API correlati

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

Un array di stringhe contenenti informazioni sulle lingue di interfaccia utente preferite dell'utente, in base alle impostazioni del sistema operativo. Le stringhe contengono i tag delle lingue (oltre a informazioni relative a script e area, se applicabili) definiti dalla RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) e utilizzano trattini come delimitatori (ad esempio, "en-US" o "ja-JP"). Le lingue sono elencate nell'array in ordine di preferenza, secondo quanto determinato delle impostazioni del sistema operativo.

I sistemi operativi sono diversi per quanto riguarda le informazioni locali restituite dalle stringhe delle versioni localizzate. Un sistema operativo può restituire"en-us", mentre un altro può restituire "en".

Generalmente, il primo elemento nell'array restituito ha lo stesso ID della lingua primaria che corrisponde alla proprietà Capabilities.language. Se, ad esempio, Capabilities.languages[0] è impostato su "en-US", la proprietà language è impostata su "en". Se tuttavia la proprietà Capabilities.language è impostata su "xu" (che specifica una lingua sconosciuta), il primo elemento in questo array sarà diverso. Per tale motivo, Capabilities.languages[0] può risultare più preciso di Capabilities.language.

La stringa server è LS.

Altri esempi

Specifica se l'accesso in lettura al disco rigido dell'utente è stato negato (true) o consentito (false) dall'amministratore. Per il contenuto di Adobe AIR, questa proprietà è applicabile unicamente al contenuto di sandbox di sicurezza diverse da quella dell'applicazione. (Il contenuto della sandbox di sicurezza dell'applicazione può sempre leggere dal sistema.) Se questa proprietà è true, Flash Player non è in grado di leggere i file (compreso il primo file con cui viene lanciato) dal disco rigido dell'utente. Se questa proprietà è true, il contenuto di AIR al di fuori della sandbox di sicurezza dell'applicazione non può leggere file dal disco rigido dell'utente. Ad esempio, i tentativi di leggere un file presente nel disco rigido dell'utente mediante i metodi di caricamento danno esito negativo se questa proprietà è impostata su true.

Se la proprietà è impostata su true, anche la lettura delle librerie condivise di runtime viene bloccata, tuttavia la lettura degli oggetti condivisi locali viene consentita a prescindere dal valore di questa proprietà.

La stringa server è LFD.

Elementi API correlati

Specifica il produttore della versione di Flash Player o di AIR runtime in esecuzione, nel formato "Adobe OSName". Il valore di OSName potrebbe essere "Windows", "Macintosh", "Linux" o il nome di un altro sistema operativo. La stringa server è M.

Non utilizzate Capabilities.manufacturer per determinare una funzionalità in base al sistema operativo se esiste una proprietà di funzionalità più specifica. Basarsi sul sistema operativo non è una buona idea, poiché si potrebbero incontrare problemi se un'applicazione non considera tutti i potenziali sistemi target. Usate invece la proprietà corrispondente alla funzionalità che state verificando. Per ulteriori informazioni, vedete la descrizione della classe.

Recupera livello IDC H.264 più elevato che l'hardware del client supporta. Le esecuzioni multimediali sono garantite a questo livello; al livello più elevato potrebbero non funzionare con la qualità massima. Questa proprietà è utile per i server che tentano di indirizzare le capacità del client. Utilizzando questa proprietà, un server è in grado di determinare il livello del video da inviare al client.

La stringa server è ML.

Indica il sistema operativo corrente. La proprietà os può restituire le stringhe seguenti:

La stringa server è OS.

Non utilizzate Capabilities.manufacturer per determinare una funzionalità in base al sistema operativo se esiste una proprietà di funzionalità più specifica. Basarsi sul sistema operativo non è una buona idea, poiché si potrebbero incontrare problemi se un'applicazione non considera tutti i potenziali sistemi target. Usate invece la proprietà corrispondente alla funzionalità che state verificando. Per ulteriori informazioni, vedete la descrizione della classe.

Indica il rapporto proporzionale dei pixel dello schermo. La stringa server è AR.

Specifica il tipo di ambiente di runtime. Questa proprietà può avere uno dei seguenti valori:

• "ActiveX" per il controllo ActiveX di Flash Player utilizzato da Microsoft Internet Explorer.
• "Desktop" per Adobe AIR runtime (tranne che per contenuto SWF caricato da una pagina HTML, con Capabilities.playerType impostato su "PlugIn").
• "External" per Flash Player esterno o in modalità di prova
• "PlugIn" per il plug-in del browser di Flash Player (e per contenuto SWF caricato da una pagina HTML in un'applicazione AIR).
• "StandAlone" per la versione autonoma di Flash Player.

La stringa server è PT.

Indica il colore dello schermo. Questa proprietà può avere i valori "color", "gray" e "bw", che rappresentano rispettivamente il colore, la scala di grigi e il bianco e nero. La stringa server è COL.

Indica la risoluzione dpi (dots per inch, punti per pollice), espressa in pixel. La stringa server è DP.

Indica la risoluzione orizzontale massima dello schermo. La stringa server è R (che restituisce sia la larghezza che l'altezza dello schermo). Questa proprietà non si aggiorna in base alla risoluzione dello schermo dell'utente, ma indica soltanto la risoluzione al momento dell'avvio di Flash Player o di un'applicazione Adobe AIR. Inoltre, il valore è riferito unicamente allo schermo principale.

Altri esempi

Indica la risoluzione verticale massima dello schermo. La stringa server è R (che restituisce sia la larghezza che l'altezza dello schermo). Questa proprietà non si aggiorna in base alla risoluzione dello schermo dell'utente, ma indica soltanto la risoluzione al momento dell'avvio di Flash Player o di un'applicazione Adobe AIR. Inoltre, il valore è riferito unicamente allo schermo principale.

Altri esempi

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

Una stringa con codifica URL che specifica i valori per ciascuna proprietà Capabilities.

L'esempio seguente mostra una stringa con codifica 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

Altri esempi

Specifica se il sistema supporta l'esecuzione di processi a 32 bit. La stringa server è PR32.

Specifica se il sistema supporta l'esecuzione di processi a 64 bit. La stringa server è PR64.

Specifica il tipo di touch screen eventualmente supportato. I valori sono definiti nella classe flash.system.TouchscreenType.

Elementi API correlati

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

Specifica informazioni sulla piattaforma e sulla versione di Flash Player o Adobe^® AIR^®. Il formato del numero della versione è: piattaforma versione principale, versione minore, numero build, numero build interno. I valori possibili per platform sono "WIN", ` "MAC", "LNX" e "AND". Di seguito sono forniti alcuni esempi di informazioni sulla versione:

	 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
	 

Non utilizzate Capabilities.version per determinare una funzionalità in base al sistema operativo se esiste una proprietà di funzionalità più specifica. Basarsi sul sistema operativo non è una buona idea, poiché si potrebbero incontrare problemi se un'applicazione non considera tutti i potenziali sistemi target. Usate invece la proprietà corrispondente alla funzionalità che state verificando. Per ulteriori informazioni, vedete la descrizione della classe.

La stringa server è V.

Altri esempi

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

Specifica se il sistema supporta l'audio multicanale di un tipo specifico. La classe flash.media.AudioDecoder enumera i tipi possibili.

Supporto profili AIR: l'audio multicanale è supportato solo nei dispositivi AIR per TV. Su tutti gli altri dispositivi, questo metodo restituisce sempre false. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.

Nota: quando utilizzate uno dei codec audio DTS, in alcuni scenari hasMultiChannelAudio() restituiscetrue, ma l'audio DTS non viene riprodotto. Considerate, ad esempio, un lettore Blu-ray con un output S/PDIF, collegato a un vecchio amplificatore. Il vecchio amplificatore non supporta DTS, ma S/PDIF non dispone di un protocollo per notificarlo al lettore Blu-ray. Il lettore Blu-ray invia il flusso DTS al vecchio amplificatore, ma non viene emesso alcun suono. Di conseguenza, quando utilizzate DTS, è buona norma fornire un'interfaccia utente in modo che l'utente possa indicare se non viene riprodotto alcun suono. L'applicazione potrà quindi ripristinare un codec diverso.

Nella tabella seguente sono riportate le stringhe server per i singoli tipi di audio multicanale:

Parametri

Elementi API correlati

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