Loading and running experiments

Using MWClient

The primary (and recommended) way to load, run, and monitor experiments on an iOS device is via MWClient running on a Mac. When used in this way, MWorks’ iOS app plays the same role as MWServer on macOS.

First, launch MWorks on the iOS device. The app will display a listening address (i.e. the network address of your device) and a listening port (which will be 19989, unless you’ve changed it in Settings).

Next, on your Mac, launch MWClient. Click the red circle with white X next to “No connection”. In the dialog that opens, enter the iOS app’s listening address in the “address” field and its listening port in the “port” field. Finally, click “connect”.

MWClient should now display a green circle with white check mark next to the name of your iOS device. From here, you can load and run experiments as usual.

On the device

You can also load and run experiments directly on your iOS device.

After launching the MWorks app, tap “Choose experiment”. In the document picker that appears, you can select an experiment stored in the cloud (e.g. in iCloud Drive or Dropbox) or locally on the device. To load one of MWorks’ example experiments, navigate to On My iPad ➝ MWorks ➝ Examples, and tap one of the example XML files.

Note: If your experiment requires supporting files (images, sounds, etc.), you must select them (or the folders containing them) along with your experiment XML file. To do this, navigate to the location of the experiment’s files, tap “Select”, check the XML file and all required supporting files/folders, and then tap “Open”. If you omit any required files, the experiment will fail to load. Be sure to include only one XML file in your selection.

Note: At present, MWEL files cannot be loaded directly on an iOS device. Instead, they must be loaded via MWClient on a Mac.

Once you have made a selection, MWorks will load the experiment and then present a dialog offering to run or close it. To start the experiment, tap “Run”. The experiment will run until completion, after which another run/close dialog will appear. When you’re finished running the experiment, tap “Close” to unload it. You may now select and run another experiment.