Debugging and Configuring Shumway

Using the Inspector

The inspector provided as one of the examples. The local web server shall be used to open the inspector web page -- the files/resources are loaded using XMLHttpRequest, which is not working for local file system. The local web server can be created by the python -m SimpleHTTPServer (or make server) command.

The inspector is located in the examples/inspector folder and can be opened in the browser using e.g. http://localhost:8000/examples/inspector/inspector.html url. The "Open File" button can be used to open SWF and ABC files from the local system.

The inspector has several push buttons:

• Sys - when pushed, the Shumway tries to compile (vs only interpret) playerglobal's byte code to JavaScript;
• App - when pushed, tries to compile SWF file byte code;
• Verifier - when pushed, uses additional optimization for the compiled code;
• Trace - when pushed, the additional message about compilation, interpretation or property accesses will be logged in the console;
• Release - when pushed, does not run debug asserts during code execution;
• Symbols - when pushed, displays information about symbols that are currently on stage (hover mouse to see more information).

The inspector accepts number of arguments in the query string:

• rfile - loads and opens specified SWF file, e.g. http://localhost:8000/examples/inspector/inspector.html?rfile=../examples/racing/race3.swf will automatically open and run race3 file;
• async - if true is specified, the inspector will use progressive loading of the file;
• paused - if true is specified, the movie will be opened paused, use Command/Ctrl+F8 to start running;
• size - specifies the size of the movie in the <width>x<height> format (e.g. 320x240);
• yt - allows to specify video ID and open youtube video by sniffing flashvars from the HTML page, requires systemXHR permission (see how to enable permissions at https://github.com/mozilla-b2g/gaia/blob/master/apps/email/README.md).

All (other) parameters will be treated as flash movie parameters (flashvars).

Using the Extension

The additional configuration parameters can be set in the about:config to change the default Shumway behavior:

• shumway.ignoreCTP (boolean) - for Firefox 21 and up, the extension is shown only when the click-to-play is enabled (and native Flash plug-in is installed). Set the value of this key to true to bypass this check and always show the Shumway extension instead of the plug-in;
• shumway.simpleMode (boolean) - if true is specified, the simple HTML page with two button will be shown (Shumway and Flash);
• shumway.dummyMode (boolean) - if true is specified, replaces the movie with bouncing ball animation;
• shumway.whitelist (string) - comma-separated list for the sites/domains that can be accessed using URLStream/NetStream objects, if the requested originated to the different from the movie domain;
• shumway.external (boolean) - if true is specified, allows movie to communicated with the web page using the ExternalInterface.