This plugin allows integrating a Construct project with the YouTube Playables SDK.
Using the plugin
Install the addon to Construct, and then add the YouTube Playables to your project. Merely adding the plugin to your project automatically handles some of the basic Playables SDK requirements, including:
- The Playables SDK will be loaded before the Construct engine
- The firstFrameReady and gameReady calls will be made
- Pause & resume will occur based on the Playables SDK events
- Audio will be automatically muted based on Playables SDK events
Note that you can use a loader layout to ensure the gameReady call is made sooner, as the requirements indicate it must be called within 5 seconds. The firstFrameReady call is made as soon as the Construct engine is ready and able to show its own loading indicator, and gameReady is called as soon as the first layout starts. Loader layouts can be run before the rest of the project is downloaded and so provide a way to make sure the gameReady call happens sooner.
The YouTube Playables platform also has some download size limits. See the guide on Optimizing download size for tips on that.
Supported SDK features
The YouTube Playables Construct plugin supports the following features:
- Sending score
- Cloud save
- Identifying when running in the Playables environment
- Identifying the language provided by the Playables platform
- Identifying the Playables SDK version
You may need to integrate some of these features with your project to meet the YouTube Playables publishing requirements.
In some cases you may need to adapt your game's features for the Playables platform. For example you may want to hide your game's own audio mute button and instead rely on the Playables platform mute feature. You can use the In Playables environment condition of this plugin to identify when it's running in the Playables platform and adapt the game accordingly. This means you can create one web export that works both for YouTube Playables and on the open web.
Testing
To test your project, you can use the YouTube Playables Test Suite. This requires a URL to your game. Use a normal web export from Construct. You can use a local development web server running on localhost, or alternatively upload your project to a publicly accessible web server like with any other web export (see Publishing to the web). Then you can copy and paste the URL to the test tool, and it will automatically verify if it meets the requirements.
Publishing
If you are interested in submitting your game or company for Playables consideration, fill out the Playables interest form.