Pacchettoflash.system
Classepublic final class Capabilities
EreditarietàCapabilities Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Capabilities fornisce le proprietà che descrivono il sistema e il lettore sui quali risiede un file SWF. 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 da 1000 pixel quadrati ed essere a colori. Se si utilizza l'oggetto Capabilities per determinare il tipo di dispositivo dell'utente, è possibile 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.

È possibile inviare le informazioni relative alle capacità di un lettore, 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 dotato di supporto MP3, impostato su una risoluzione dello schermo di 1600 x 1200 pixel e su cui sono in esecuzione Windows XP con IME (Input Method Editor) installato:

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

Nella tabella seguente sono riportate le proprietà ActionScript possibili e le stringhe server corrispondenti:

Proprietà ActionScriptStringa server
avHardwareDisableAVD
hasAccessibilityACC
hasAudioA
hasAudioEncoderAE
hasEmbeddedVideoEV
hasIMEIME
hasMP3MP3
hasPrintingPR
hasScreenBroadcastSB
hasScreenPlaybackSP
hasStreamingAudioSA
hasStreamingVideoSV
hasTLSTLS
hasVideoEncoderVE
isDebuggerDEB
languageL
localFileReadDisableLFD
manufacturerM
osOS
pixelAspectRatioAR
playerTypePT
screenColorCOL
screenDPIDP
screenResolutionXR
screenResolutionYR
versioneV

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

Vedere gli esempi

Vedere anche

Uso della classe Capabilities


Proprietà pubbliche
 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
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  hasAccessibility: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) la comunicazione mediante strumenti di supporto all'accessibilità.
Capabilities
  hasAudio: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema dotato di funzionalità audio.
Capabilities
  hasAudioEncoder: Boolean
[statico] [sola lettura] Indica se il lettore è in grado (true) o meno (false) di codificare uno streaming audio (ad esempio, quello catturato da un microfono).
Capabilities
  hasEmbeddedVideo: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) video incorporati.
Capabilities
  hasIME: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema fornito (true) o meno (false) di IME (Input Method Editor).
Capabilities
  hasMP3: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema che dispone (true) o meno (false) di un decodificatore MP3.
Capabilities
  hasPrinting: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) la stampa.
Capabilities
  hasScreenBroadcast: Boolean
[statico] [sola lettura] Indica se il lettore 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 lettore 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 lettore è in grado (true) o meno (false) di riprodurre lo streaming audio.
Capabilities
  hasStreamingVideo: Boolean
[statico] [sola lettura] Specifica se il lettore è in grado (true) o meno (false) di riprodurre il video in streaming.
Capabilities
  hasTLS: Boolean
[statico] [sola lettura] Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) socket SSL nativi mediante NetConnection.
Capabilities
  hasVideoEncoder: Boolean
[statico] [sola lettura] Indica se il lettore è 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 lettore è una speciale versione di debug (true) oppure una release ufficiale (false).
Capabilities
  language: String
[statico] [sola lettura] Indica il codice di lingua del sistema su cui è in esecuzione il lettore.
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] Indica il produttore di Flash Player, nel formato "Adobe OSName".
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] Indica il tipo di lettore.
Capabilities
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  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
  version: String
[statico] [sola lettura] Specifica le informazioni sulla versione di Flash Player e la piattaforma.
Capabilities
Metodi pubblici
 MetodoDefinito da
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
avHardwareDisableproprietà
avHardwareDisable:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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


Implementazione
    public static function get avHardwareDisable():Boolean

Vedere anche

hasAccessibilityproprietà 
hasAccessibility:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) la comunicazione mediante strumenti di supporto all'accessibilità. La stringa server è ACC.


Implementazione
    public static function get hasAccessibility():Boolean

Vedere anche

hasAudioproprietà 
hasAudio:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema dotato di funzionalità audio. Questa proprietà è sempre true. La stringa server è A.


Implementazione
    public static function get hasAudio():Boolean
hasAudioEncoderproprietà 
hasAudioEncoder:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore è 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
hasEmbeddedVideoproprietà 
hasEmbeddedVideo:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) il video incorporato. La stringa server è EV.


Implementazione
    public static function get hasEmbeddedVideo():Boolean
hasIMEproprietà 
hasIME:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema fornito (true) o meno (false) di IME (Input Method Editor). La stringa server è IME.


Implementazione
    public static function get hasIME():Boolean

Vedere anche

hasMP3proprietà 
hasMP3:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema che dispone (true) o meno (false) di un decodificatore MP3. La stringa server è MP3.


Implementazione
    public static function get hasMP3():Boolean

Vedere anche

hasPrintingproprietà 
hasPrinting:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema che supporta (true) o meno (false) le funzionalità di stampa. La stringa server è PR.


Implementazione
    public static function get hasPrinting():Boolean
hasScreenBroadcastproprietà 
hasScreenBroadcast:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore 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
hasScreenPlaybackproprietà 
hasScreenPlayback:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore 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
hasStreamingAudioproprietà 
hasStreamingAudio:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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


Implementazione
    public static function get hasStreamingAudio():Boolean
hasStreamingVideoproprietà 
hasStreamingVideo:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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


Implementazione
    public static function get hasStreamingVideo():Boolean
hasTLSproprietà 
hasTLS:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore viene eseguito su un sistema che supporta (true) o non supporta (false) socket SSL nativi mediante NetConnection. La stringa server è TLS.


Implementazione
    public static function get hasTLS():Boolean

Vedere anche

hasVideoEncoderproprietà 
hasVideoEncoder:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore è 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
isDebuggerproprietà 
isDebugger:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il lettore è una speciale versione di debug (true), oppure una release ufficiale (false). La stringa server è DEB.


Implementazione
    public static function get isDebugger():Boolean
languageproprietà 
language:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica il codice di lingua del sistema su cui è in esecuzione il lettore. 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:

LinguaValore
Cecocs
Daneseda
Olandesenl
Inglese (English)it
Finlandesefi
Francesefr
Tedescode
Ungherese (Hungarian)hu
Italianoit
Giapponeseja
Coreanoko
Norvegeseno
Altre/sconosciutexu
Polaccopl
Portoghesept
Russoru
Cinese semplificato (Simplified Chinese)zh-CN
Spagnoloes
Svedesesv
Cinese tradizionalezh-TW
Turcotr

La stringa server è L.


Implementazione
    public static function get language():String

Esempio

Nel seguente esempio viene visualizzato un contenuto diverso a seconda del sistema operativo utilizzato dall’utente.

La proprietà Capabilities.language restituisce il codice lingua ISO 639-1 (per esempio "en" per l’inglese). La dichiarazione 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);
        }
    }
}
localFileReadDisableproprietà 
localFileReadDisable:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Specifica se l'accesso in lettura al disco rigido dell'utente è stato negato (true) o consentito (false) dall'amministratore. Se questa proprietà è true, Flash Player non è in grado di leggere i file (compreso il primo file SWF con cui viene avviato) 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

Vedere anche

manufacturerproprietà 
manufacturer:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica il produttore di Flash Player, 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.


Implementazione
    public static function get manufacturer():String
osproprietà 
os:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica il sistema operativo corrente. La proprietà os può restituire le stringhe seguenti: "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (disponibile solo nel Flash Player SDK e non nella versione desktop), "Linux" e "MacOS". La stringa server è OS.


Implementazione
    public static function get os():String
pixelAspectRatioproprietà 
pixelAspectRatio:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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


Implementazione
    public static function get pixelAspectRatio():Number
playerTypeproprietà 
playerType:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica il tipo di lettore. Questa proprietà può avere uno dei seguenti valori:

La stringa server è PT.


Implementazione
    public static function get playerType():String
screenColorproprietà 
screenColor:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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
screenDPIproprietà 
screenDPI:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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


Implementazione
    public static function get screenDPI():Number
screenResolutionXproprietà 
screenResolutionX:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica la risoluzione orizzontale massima dello schermo. La stringa server è R (che restituisce sia la larghezza che l'altezza dello schermo).


Implementazione
    public static function get screenResolutionX():Number

Vedere anche

screenResolutionYproprietà 
screenResolutionY:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica la risoluzione verticale massima dello schermo. La stringa server è R (che restituisce sia la larghezza che l'altezza dello schermo).


Implementazione
    public static function get screenResolutionY():Number

Vedere anche

serverStringproprietà 
serverString:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Vedere anche

versionproprietà 
version:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Specifica le informazioni sulla versione di Flash Player e la piattaforma. Il formato del numero della versione è: piattaforma versione principale, versione minore, numero build, numero build interno. I valori possibili per platform sono "WIN", "MAC" e "UNIX". Di seguito sono forniti alcuni esempi di informazioni sulla versione:

  WIN 9,0,0,0 // Flash Player 9 per Windows
  MAC 7,0,25,0 // Flash Player 7 per Macintosh
  UNIX 5,0,55,0 // Flash Player 5 per UNIX
  

La stringa server è V.


Implementazione
    public static function get version():String

Vedere anche

Esempi Come utilizzare gli esempi
CapabilitiesExample.as

L'esempio seguente produce i valori disponibili nell'oggetto flash.system.Capabilities mediante numerose chiamate a 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);
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/system/Capabilities.html