Capabilities - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 )

Pacchetto	flash.system
Classe	public final class Capabilities
Ereditarietà	Capabilities Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

La classe Capabilities fornisce le proprietà che descrivono il sistema e il runtime sui quali risiede l'applicazione. Ad esempio, lo schermo di un telefono cellulare potrebbe avere una risoluzione di 100 pixel quadrati ed essere in bianco e nero e lo schermo di un PC una risoluzione di 1000 pixel quadrati ed essere a colori. Utilizzando la classe Capabilities per determinare le capacità del client, potete fornire il contenuto appropriato al maggior numero di utenti possibile. Una volta che si conoscono le capacità del dispositivo, è possibile fare in modo che il server invii i file SWF appropriati, oppure fare in modo che il file SWF modifichi la propria presentazione.

Tuttavia, alcune funzionalità di Adobe AIR non sono indicate come proprietà nella classe Capabilities. Sono proprietà di altre classi:

Proprietà	Descrizione
`NativeApplication.supportsDockIcon`	Se il sistema operativo supporta le icone del dock dell'applicazione.
`NativeApplication.supportsMenu`	Se il sistema operativo corrente supporta una barra di menu dell'applicazione globale.
`NativeApplication.supportsSystemTrayIcon`	Se il sistema operativo supporta le icone della barra delle applicazioni.
`NativeWindow.supportsMenu`	Se il sistema operativo supporta i menu delle finestre.
`NativeWindow.supportsTransparency`	Se il sistema operativo supporta le finestre trasparenti.

Non utilizzate Capabilities.os o Capabilities.manufacturer per determinare una funzionalità in base al sistema operativo. 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.

Potete inviare le informazioni relative alle capacità, archiviate nella proprietà Capabilities.serverString sotto forma di stringa con codifica URL, utilizzando i metodi HTTP GET o POST. L'esempio seguente mostra una stringa server per un computer con supporto MP3 e risoluzione di 1600 x 1200 pixel, che esegue Windows XP con un IME (input method editor) installato, senza supporto per l'audio multicanale:

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

Nella tabella seguente sono elencate le proprietà della classe Capabilities e le stringhe server corrispondenti. Sono anche elencate le stringhe server per i tipi di audio multicanale.

Proprietà della classe Capabilities	Stringa server
`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`
`Supporta l'audio Dolby Digital`	`DD`
`Supporta l'audio Dolby Digital Plus`	`DDP`
`Supporta l'audio DTS`	`DTS`
`Supporta l'audio DTS Express`	`DTE`
`Supporta l'audio DTS-HD High Resolution`	`DTH`
`Supporta l'audio DTS-HD Master`	`DTM`

È inoltre disponibile una stringa server WD che specifica se la modalità senza finestra è attivata. La modalità senza finestra può essere disattivata in Flash Player a causa dell'incompatibilità con il browser Web o di un'impostazione dell'utente nel file mms.cfg. Non è disponibile una proprietà Capabilities corrispondente.

Tutte le proprietà della classe Capabilities sono di sola lettura.

Vedere gli esempi

Altri esempi

Determining Flash Player version in Flex
Uso della classe Capabilities

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		avHardwareDisable : Boolean [statico] [sola lettura] Specifica se l'accesso alla fotocamera e al microfono dell'utente è stato negato (true) o consentito (false) dall'amministratore.	Capabilities
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		cpuArchitecture : String [statico] [sola lettura] Specifica l'architettura CPU corrente.	Capabilities
		hasAccessibility : Boolean [statico] [sola lettura] Specifica se il sistema supporta (true) o meno (false) comunicazioni con strumenti di supporto all'accessibilità.	Capabilities
		hasAudio : Boolean [statico] [sola lettura] Specifica se il sistema è dotato di funzionalità audio.	Capabilities
		hasAudioEncoder : Boolean [statico] [sola lettura] Indica se il sistema è in grado (true) o meno (false) di codificare uno streaming audio (ad esempio, quello catturato da un microfono).	Capabilities
		hasEmbeddedVideo : Boolean [statico] [sola lettura] Specifica se il sistema supporta (true) o meno (false) il video incorporato.	Capabilities
		hasIME : Boolean [statico] [sola lettura] Indica se il sistema presenta (true) o meno (false) un IME (Input Method Editor) installato.	Capabilities
		hasMP3 : Boolean [statico] [sola lettura] Specifica se il sistema presenta (true) o meno (false) un decodificatore MP3.	Capabilities
		hasPrinting : Boolean [statico] [sola lettura] Specifica se il sistema supporta (true) o meno (false) la stampa.	Capabilities
		hasScreenBroadcast : Boolean [statico] [sola lettura] Indica se il sistema supporta (true) o meno (false) lo sviluppo di applicazioni di trasmissione su schermo da eseguire mediante Flash Media Server.	Capabilities
		hasScreenPlayback : Boolean [statico] [sola lettura] Indica se il sistema supporta (true) o meno (false) la riproduzione di applicazioni di trasmissione su schermo che vengono eseguite mediante Flash Media Server.	Capabilities
		hasStreamingAudio : Boolean [statico] [sola lettura] Specifica se il sistema è in grado (true) o meno (false) di riprodurre lo streaming audio.	Capabilities
		hasStreamingVideo : Boolean [statico] [sola lettura] Specifica se il sistema è in grado (true) o meno (false) di riprodurre lo streaming video.	Capabilities
		hasTLS : Boolean [statico] [sola lettura] Indica se il sistema supporta (true) o meno (false) socket SSL nativi mediante NetConnection.	Capabilities
		hasVideoEncoder : Boolean [statico] [sola lettura] Indica se il sistema è in grado (true) o meno (false) di codificare uno streaming video (ad esempio, quello proveniente da una webcam).	Capabilities
		isDebugger : Boolean [statico] [sola lettura] Indica se il sistema è una speciale versione di debug (true), oppure una release ufficiale (false).	Capabilities
		isEmbeddedInAcrobat : Boolean [statico] [sola lettura] Specifica se il runtime Flash è incorporato in un file PDF aperto in Acrobat 9.0 o versione successiva (true) o non è aperto (false).	Capabilities
		language : String [statico] [sola lettura] Indica il codice di lingua del sistema su cui è in esecuzione il contenuto.	Capabilities
		languages : Array [statico] [sola lettura] Un array di stringhe contenenti informazioni sulle lingue di interfaccia utente preferite dell'utente, in base alle impostazioni del sistema operativo.	Capabilities
		localFileReadDisable : Boolean [statico] [sola lettura] Specifica se l'accesso in lettura al disco rigido dell'utente è stato negato (true) o consentito (false) dall'amministratore.	Capabilities
		manufacturer : String [statico] [sola lettura] Specifica il produttore della versione di Flash Player o di AIR runtime in esecuzione, nel formato "Adobe OSName".	Capabilities
		maxLevelIDC : String [statico] [sola lettura] Recupera livello IDC H.264 più elevato che l'hardware del client supporta.	Capabilities
		os : String [statico] [sola lettura] Indica il sistema operativo corrente.	Capabilities
		pixelAspectRatio : Number [statico] [sola lettura] Indica il rapporto proporzionale dei pixel dello schermo.	Capabilities
		playerType : String [statico] [sola lettura] Specifica il tipo di ambiente di runtime.	Capabilities
		screenColor : String [statico] [sola lettura] Indica il colore dello schermo.	Capabilities
		screenDPI : Number [statico] [sola lettura] Indica la risoluzione dpi (dots per inch, punti per pollice), espressa in pixel.	Capabilities
		screenResolutionX : Number [statico] [sola lettura] Indica la risoluzione orizzontale massima dello schermo.	Capabilities
		screenResolutionY : Number [statico] [sola lettura] Indica la risoluzione verticale massima dello schermo.	Capabilities
		serverString : String [statico] [sola lettura] Una stringa con codifica URL che specifica i valori per ciascuna proprietà Capabilities.	Capabilities
		supports32BitProcesses : Boolean [statico] [sola lettura] Specifica se il sistema supporta l'esecuzione di processi a 32 bit.	Capabilities
		supports64BitProcesses : Boolean [statico] [sola lettura] Specifica se il sistema supporta l'esecuzione di processi a 64 bit.	Capabilities
		touchscreenType : String [statico] [sola lettura] Specifica il tipo di touch screen eventualmente supportato.	Capabilities
		version : String [statico] [sola lettura] Specifica le informazioni sulla piattaforma e sulla versione di Flash Player o Adobe® AIR®.	Capabilities

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		hasMultiChannelAudio(type:String):Boolean [statico] Specifica se il sistema supporta l'audio multicanale di un tipo specifico.	Capabilities
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Descrizione delle proprietà

avHardwareDisable

proprietà

avHardwareDisable:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get avHardwareDisable():Boolean

Elementi API correlati

flash.media.Camera.getCamera()
flash.media.Microphone.getMicrophone()
Security.showSettings()

cpuArchitecture

proprietà

cpuArchitecture:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10.0.32, AIR 1.5.1

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

Implementazione
public static function get cpuArchitecture():String

hasAccessibility

proprietà

hasAccessibility:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasAccessibility():Boolean

Elementi API correlati

flash.accessibility.Accessibility.active
flash.accessibility.Accessibility.updateProperties()

hasAudio

proprietà

hasAudio:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasAudio():Boolean

hasAudioEncoder

proprietà

hasAudioEncoder:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get hasAudioEncoder():Boolean

hasEmbeddedVideo

proprietà

hasEmbeddedVideo:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasEmbeddedVideo():Boolean

hasIME

proprietà

hasIME:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasIME():Boolean

Altri esempi

Uso della classe IME

Elementi API correlati

flash.system.IME
flash.system.System.ime

hasMP3

proprietà

hasMP3:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasMP3():Boolean

Altri esempi

Uso della classe Capabilities

hasPrinting

proprietà

hasPrinting:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasPrinting():Boolean

hasScreenBroadcast

proprietà

hasScreenBroadcast:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get hasScreenBroadcast():Boolean

hasScreenPlayback

proprietà

hasScreenPlayback:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get hasScreenPlayback():Boolean

hasStreamingAudio

proprietà

hasStreamingAudio:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasStreamingAudio():Boolean

hasStreamingVideo

proprietà

hasStreamingVideo:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasStreamingVideo():Boolean

hasTLS

proprietà

hasTLS:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get hasTLS():Boolean

Elementi API correlati

flash.net.NetConnection.connectedProxyType
flash.net.NetConnection.proxyType
flash.net.NetConnection.usingTLS

hasVideoEncoder

proprietà

hasVideoEncoder:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get hasVideoEncoder():Boolean

isDebugger

proprietà

isDebugger:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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).

Implementazione
public static function get isDebugger():Boolean

isEmbeddedInAcrobat

proprietà

isEmbeddedInAcrobat:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9.0.127.0, AIR 1.1, Flash Lite 4

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

Implementazione
public static function get isEmbeddedInAcrobat():Boolean

Altri esempi

Uso della classe Capabilities

language

proprietà

language:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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:

Lingua	Valore
Ceco	`cs`
Danese	`da`
Olandese	`nl`
Inglese	`en`
Finlandese	`fi`
Francese	`fr`
Tedesco	`de`
Ungherese	`hu`
Italiano	`it`
Giapponese	`ja`
Coreano	`ko`
Norvegese	`nb`
Altre/sconosciute	`xu`
Polacco	`pl`
Portoghese	`pt`
Russo	`ru`
Cinese semplificato	`zh-CN`
Spagnolo	`es`
Svedese	`sv`
Cinese tradizionale	`zh-TW`
Turco	`tr`

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.

Implementazione
public static function get language():String

Altri esempi

Selezione delle impostazioni locali

Elementi API correlati

lingue

Esempio ( Come utilizzare questo esempio )

Nell'esempio che segue, il contenuto visualizzato dipende dalla lingua del sistema operativo dell'utente.

La proprietà Capabilities.language restituisce il codice lingua ISO 639-1 (per esempio "en" per l'inglese). L'istruzione switch controlla il codice lingua e inserisce nel campo di testo myTextField un saluto nella lingua specificata. Se il codice lingua non è supportato dall'esempio, viene restituita una stringa di errore predefinita.

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

proprietà

languages:Array [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.1

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.

Implementazione
public static function get languages():Array

Altri esempi

Selezione delle impostazioni locali

localFileReadDisable

proprietà

localFileReadDisable:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get localFileReadDisable():Boolean

Elementi API correlati

flash.display.Loader

manufacturer

proprietà

manufacturer:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get manufacturer():String

maxLevelIDC

proprietà

maxLevelIDC:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Implementazione
public static function get maxLevelIDC():String

os

proprietà

os:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Sistema operativo	Valore
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 corrisponde al numero di versione, ad esempio `"Mac OS 10.5.2"`)
Linux	`"Linux"` (Flash Player associa la versione Linux, ad esempio`"Linux 2.6.15-1.2054_FC5smp"`
iPhone OS 4.1	`"iPhone3,1"`

La stringa server è OS.

Implementazione
public static function get os():String

pixelAspectRatio

proprietà

pixelAspectRatio:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get pixelAspectRatio():Number

playerType

proprietà

playerType:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get playerType():String

screenColor

proprietà

screenColor:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get screenColor():String

screenDPI

proprietà

screenDPI:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get screenDPI():Number

screenResolutionX

proprietà

screenResolutionX:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get screenResolutionX():Number

Altri esempi

Uso della classe Capabilities

screenResolutionY

proprietà

screenResolutionY:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get screenResolutionY():Number

Altri esempi

Uso della classe Capabilities

Esempio ( Come utilizzare questo esempio )

L'esempio seguente è un semplice test che indica la risoluzione corrente dello schermo e la versione del sistema operativo. Quando provate questo esempio, fate clic sul campo di testo per vedere i valori delle proprietà:

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

proprietà

serverString:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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

Implementazione
public static function get serverString():String

Altri esempi

Uso della classe Capabilities

supports32BitProcesses

proprietà

supports32BitProcesses:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10.0.32, AIR 1.5.2

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

Implementazione
public static function get supports32BitProcesses():Boolean

supports64BitProcesses

proprietà

supports64BitProcesses:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10.0.32, AIR 1.5.2

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

Implementazione
public static function get supports64BitProcesses():Boolean

touchscreenType

proprietà

touchscreenType:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10.1, AIR 2

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

Implementazione
public static function get touchscreenType():String

Elementi API correlati

Classe TouchscreenType
flash.ui.Mouse.supportsCursor

Esempio ( Come utilizzare questo esempio )

L'esempio seguente è un semplice test che indica il tipo corrente di touch screen. Quando provate questo esempio, fate clic su un campo di testo per vedere i valori delle proprietà:

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

proprietà

version:String [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

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.

Implementazione
public static function get version():String

Altri esempi

Uso della classe Capabilities

Esempio ( Come utilizzare questo esempio )

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

Descrizione dei metodi

hasMultiChannelAudio

()

metodo

public static function hasMultiChannelAudio(type:String):Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 11, AIR 3

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:

Tipo di audio multicanale	Stringa server
`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`

Parametri

type:String — Un valore String che rappresenta un tipo di audio multicanale. I valori validi sono le costante definite in flash.media.AudioDecoder.

Restituisce

Boolean — Il valore booleano true se il sistema supporta il tipo di audio multicanale passato nel parametro type. In caso contrario, il valore restituito è false.

Elementi API correlati

flash.media.AudioDecoder

Esempio ( Come utilizzare questo esempio )

Il codice seguente traccia il valore restituito da una chiamata di hasMultiChannelAudio(). Il valore restituito indica se il sistema supporta l'audio multicanale Dolby Digital.

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

Esempi Come utilizzare questo esempio

CapabilitiesExample.as

L'esempio seguente produce i valori di presenti nell'oggetto flash.system.Capabilities. Innanzitutto, il valore viene inserito in un campo di testo. Quindi vengono generati i valori tramite diverse chiamate a 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);
       
        }
    }
}

Note legali | Informativa sulla privacy online

Capabilities - AS3

Classi x

avHardwareDisable

cpuArchitecture

hasAccessibility

hasAudio

hasAudioEncoder

hasEmbeddedVideo

hasIME

hasMP3

hasPrinting

hasScreenBroadcast

hasScreenPlayback

hasStreamingAudio

hasStreamingVideo

hasTLS

hasVideoEncoder

isDebugger

isEmbeddedInAcrobat

language

languages

localFileReadDisable

manufacturer

maxLevelIDC

os

pixelAspectRatio

playerType

screenColor

screenDPI

screenResolutionX

screenResolutionY

serverString

supports32BitProcesses

supports64BitProcesses

touchscreenType

version

hasMultiChannelAudio