| 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à ActionScript | 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 |
os | OS |
pixelAspectRatio | AR |
playerType | PT |
screenColor | COL |
screenDPI | DP |
screenResolutionX | R |
screenResolutionY | R |
versione | V |
Tutte le proprietà della classe Capabilities sono di sola lettura.
Vedere gli esempi
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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:
| Lingua | Valore |
| Ceco | cs |
| Danese | da |
| Olandese | nl |
| Inglese (English) | it |
| Finlandese | fi |
| Francese | fr |
| Tedesco | de |
| Ungherese (Hungarian) | hu |
| Italiano | it |
| Giapponese | ja |
| Coreano | ko |
| Norvegese | no |
| Altre/sconosciute | xu |
| Polacco | pl |
| Portoghese | pt |
| Russo | ru |
| Cinese semplificato (Simplified Chinese) | zh-CN |
| Spagnolo | es |
| Svedese | sv |
| Cinese tradizionale | zh-TW |
| Turco | tr |
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);
}
}
}
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
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
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
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
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:
"StandAlone" per la versione autonoma di Flash Player
"External" per Flash Player esterno o in modalità di prova
"PlugIn" per il plug-in Flash Player per browser
"ActiveX" per il controllo ActiveX di Flash Player utilizzato da Microsoft Internet Explorer
La stringa server è PT.
Implementazione
public static function get playerType():String
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
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
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
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
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
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
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);
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 3:14 AM GMT-07:00
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/system/Capabilities.html