15 | * The which utility takes a command name and searches the path 16 | * for each executable file that would be run had this 17 | * command actually been invoked. 18 | *
true
13 | * Note: This class is not a component, it is just 14 | * a shim that allow to declare the SWC manifest and associate an icon file. 15 | *
15 | * Use generateRandomBytes() to generate cryptographic keys, 16 | * strong identifiers, session ids, and so on. 17 | * The random sequence is generated using cryptographically strong functions 18 | * provided by the operating system. 19 | * If the appropriate function is not available on an individual client 20 | * computer or device, then an error is thrown. 21 | *
generateRandomBytes()
24 | * Note: this is a temporary solution as the current redtamarin runtimes 25 | * does not implment flash.crypto.generateRandomBytes yet. 26 | * It will work under Linux and Mac OS X but not under Windows (unless under a cygwin shell). 27 | *
flash.crypto.generateRandomBytes
16 | * By default, all the parameters are empty (not initialised). 17 | * Only the non-empty (or initialised) parameters wil be exported 18 | * by the toDictionary() function. 19 | *
toDictionary()
12 | * Those values are examples of what we think is "common use case", 13 | * you can use any value you want. 14 | *
17 | * In general, we think you would want to differentiate between 18 | * the web: a SWF hosted in an online HTML page, 19 | * an app: an AIR application, 20 | * and commandline: a Redtamarin command-line program. 21 | *
24 | * You may want also to differentiate between 25 | * a desktop app: AIR published for the desktop 26 | * and a mobile app: AIR published for mobile. 27 | *
30 | * That said, you could use any values, here few more examples: 31 | * "cms" (content management system), "server" (when you do tracking server-side), 32 | * "shellscript" (when using a shell script vs a static binary), etc. 33 | *
type
23 | * The equivalent of analytics.js for online SWF files. 24 | *
26 | * analytics.js: 27 | * Each analytics.js tracker object starts with 20 hits that are replenished 28 | * at a rate of 2 hit per second. Applies to all hits except for ecommerce 29 | * (item or transaction). 30 | *
33 | * Features: 34 | *
RateLimiter
SharedObject
DefaultTracker
false
13 | * To integrate with a Twitter API. 14 | *
122 | * Some example of buttons: Tweet, Follow, hashtag, Mention, etc. 123 | *
HitSender
19 | * As Redtamarin doesn't have SSL support for sockets on the command-line 20 | * cURL allow to fill this void. 21 | * Mainly to be able to test with the Measurement Protocol Validation Server 22 | * which works only with HTTPS, and/or if you absolutely have to use HTTPS. 23 | *
DebugHitSender
27 | * To ensure that your hits are correctly formatted and contain all required 28 | * parameters, you can test them against the validation server before 29 | * deploying them to production. 30 | *
33 | * The sender use the endpoint /debug/collect 34 | * instead of /collect. 35 | * Hits sent to the Measurement Protocol Validation Server will not show up 36 | * in reports. They are for debugging only. 37 | *
/debug/collect
/collect
17 | * It will work only in a debug Flash Player, debug AIR application, 18 | * and with the debug redshell (or as3shebang). 19 | * It will not send any data to the Google Analytics servers. 20 | *
12 | * The strict minimum of what a sender need to implement 13 | * is to send a data model to a URL. 14 | *
17 | * For a Flash / AIR implementation see URLLoaderHitSender, 18 | * for a Redtamarin implementation see BSDSocketHitSender. 19 | *
URLLoaderHitSender
BSDSocketHitSender
13 | * Users primarily get and set field values. 14 | *
44 | * Common field names are provided as static members of the Tracker class. 45 | * You may also use your own field names to store information in the data 46 | * model but they will not be sent in the tracking beacon. 47 | *
Tracker
66 | * See the set method for a description of possible field 67 | * names. 68 | *
set
HitModel
17 | * Sampling is determined on a per-client basis as identified by 18 | * the Tracker.CLIENT_ID field. 19 | * This means that either all or none of the hits from a particular client 20 | * will be sent. 21 | *
Tracker.CLIENT_ID
24 | * By default we use the value set in Configuration, 25 | * you can edit the configuration to use something else than the 26 | * default (100%). 27 | *
Configuration
parseFloat()
SAMPLE_RATE
119 | * Values will be rounded to the nearest 100th. 120 | * Invalid numbers will return 0. 121 | * Values greater than 100 will return 100. 122 | *
0
100
12 | * To be considered as an abstract class to extend from. 13 | *
70 | * Do not use or instanciate this class directly, extend it instead. 71 | *
&NAME=VALUE
14 | * The mecanism is based on the token bucket algorithm, 15 | * and allows you to send bursts of hits to Google Analytics, 16 | * while preventing clients from sending data too quickly. 17 | *
20 | * Each tracker has a maximum limit for the number of requests it can send concurrently. 21 | * The tracker also maintain a count of the number of concurrent hits that have been sent. 22 | * As a hit is sent to Google Analytics, the count decreases by one. 23 | * When the count is 0, the maximum limit has been reached, 24 | * and no new requests are sent. 25 | * Then over a small period of time, the count is increased back to its original limit, 26 | * allowing data to be sent again. 27 | *
30 | * The limiting rate is specified in each individual trackers. 31 | * For the WebTracker, we follow what is done with analytics.js, 32 | * the tracker starts with 20 hits that are replenished at a rate of 2 hits per second. 33 | * For the ApplicationTracker, we follow what is done with the Android SDK and the iOS SDK, 34 | * each trackers starts with 60 hits that are replenished at a rate of 1 hit every 2 seconds. 35 | *
WebTracker
20
2
ApplicationTracker
60
1
capacity
rate
57 | * The token count is initialized to the maximum token capacity. 58 | *
83 | * Used internally for generating tokens and useful for testing purposes. 84 | *
102 | * A return value of false indicates that tokens are being consumed in excess 103 | * of the defined limits. 104 | *
10 | * Other names: CRC-32/ADCCP, PKZIP 11 | *
83 | * Either Endian.BIG_ENDIAN for "Most significant bit first" 84 | * or Endian.LITTLE_ENDIAN for "Least significant bit first". 85 | *
Endian.BIG_ENDIAN
Endian.LITTLE_ENDIAN
ApplicationInfo
SystemInfo
12 | * Almost the same function as generateFlashSystemInfo() 13 | * but provide a bit more details for "screenColors" and "userLanguage". 14 | *
generateFlashSystemInfo()
DisplayObject
10 | * format is xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx 11 | * where x is any hexadecimal digit 12 | * and y is oen of 8, 9, A, or B. 13 | *
xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
x
y
8
9
A
B
16 | * Note: this is a temporary solution as the current redtamarin runtimes 17 | * does not implment flash.crypto.generateRandomBytes yet. 18 | * It will work under Linux and Mac OS X but not under Windows. 19 | *
24 | * In your analytics reports you will find: 25 | *
46 | * Note: 47 | * The documentation do warn about that 48 | *
54 | * a wrong user-agent could be the reason of a hit request not being 55 | * registered by the Google Analytics Servers. 56 | *
12 | * Even if the display argument is optional, 13 | * it is the only way to obtain a reference to the stage property 14 | * to obtain the "viewport size". 15 | *
display
stage
17 | * If a display object is not added to the display list, 18 | * its stage property is set to null. 19 | *
10 | * Note: 11 | * The value of Capabilities.language property is limited to the possible 12 | * values on this list. 13 | * Because of this limitation, Adobe AIR applications should use the first 14 | * element in the Capabilities.languages array to determine the primary user 15 | * interface language for the system. 16 | *
Capabilities.language
Capabilities.languages
Screen
11 | * For example, if an AIR desktop application run on a system with 12 | * multiple screens, this function will return the screen reference 13 | * under which the app is running. 14 | *
10 | * Because System.useCodePage = false by default, 11 | * it should always be "UTF-8" (eg. we don't use the sytem code page 12 | * so we know we use Unicode). 13 | * And in the case where System.useCodePage = true 14 | * then it will return the empty string (eg. the system code page is used 15 | * so we don't know). 16 | *
System.useCodePage = false
System.useCodePage = true
9 | * The language is specified as a lowercase two-letter language code 10 | * from ISO 639-1. 11 | *
14 | * On English systems, this property returns only the language code (en), 15 | * not the country code. 16 | * On Microsoft Windows systems, this property returns the user interface (UI) 17 | * language, which refers to the language used for all menus, dialog boxes, 18 | * error messages, and help files. 19 | *