MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 666 / 816

666 Chapter 12: ActionScript Dictionary
If you set
system.useCodepage
to
true
, keep in mind that the traditional code page of the
operating system running the player must include the characters used in your external text file in
order for the text to display. For example, if you load an external text file that contains Chinese
characters, those characters will not display on a system that uses the CP1252 code page, because
that code page does not include Chinese characters.
To ensure that users on all platforms can view external text files used in your SWF files, you
should encode all external text files as Unicode and leave
System.useCodepage
set to
false
by
default. This way Flash Player 6 and later will interpret the text as Unicode.
System.capabilities object
Availability
Flash Player 6.
Description
You can use the System.capabilities object to determine the abilities of the system and player
hosting a SWF file. This allows you to tailor content for different formats. For example, the
screen of a cell phone (black and white, 100 square pixels) is different than the 1000-square-pixel
color PC screen. To provide appropriate content to as many users as possible, you can use the
System.capabilities object to determine the type of device a user has. You can then either specify
to the server to send different SWF files based on the device capabilities, or tell the SWF file to
alter its presentation based on the capabilities of the device.
You can send capabilities information using a
GET
or
POST
HTTP method. The following is an
example of a server string for a device that does not have MP3 support and has a 400 x 200 pixel,
8 x 4 centimeter screen:
"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%207%2C0%2
C0%2C226&M=Macromedia%20Windows&R=1152x864&DP=72&COL=color&AR=1.0&OS=Window
s%20XP&L=en&PT=External&AVD=f&LFD=f"
Property summary for the System.capabilities object
Property Description Server
string
System.capabilities.avHardwareDisable
Read-only; specifies whether the user’s
camera and microphone are enabled or
disabled.
AVD
System.capabilities.hasAccessibility
Indicates whether the player is running on a
system that supports communication
between Flash Player and accessibility aids. ACC
System.capabilities.hasAudio
Indicates whether the player is running on a
system that has audio capabilities. A
System.capabilities.hasAudioEncoder
Indicates whether the player is running on a
system that can encode an audio stream,
such as that coming from a microphone.
AE
System.capabilities.hasEmbeddedVideo
Indicates whether the player is running on a
system that supports embedded video.
EV