Publish to Baidu Mini Games
The runtime environment of the Baidu Mini Game is an extension of the Baidu Smart Mini Program. This provides a WebGL interface encapsulation based on the mini program environment. This greatly improves the rendering capabilities and performance. However, since these interfaces are encapsulated by the Baidu team, they are not equivalent to the browser environment.
On the engine side, in order to make the developers' workload as easy as possible, our main tasks for developers include the following:
- The engine framework is adapted to the Baidu Mini Game API, pure game logic level, users don't need any additional modifications.
- Cocos Creator editor provides a fast packaging process, directly released as a Baidu Mini Game.
- Automatic loading of remote resources, cache resources and cache resource versioning.
For specific Baidu Mini Game application, station development, game submission, review and release process can refer to Baidu Mini Game Developer Documentation.
Using Cocos Creator to release Baidu Mini Games
- Download and install Baidu Developer Tools in Baidu Developer Tools Documentation.
- Download and install the Baidu app in the app store of your phone.
Log in to Smart Mini Progame Platform and find App ID.
Select the Baidu Mini Game in the Platform of the Build panel, fill in the mini game appid, and then click Build.
After the build is completed, a Baidu mini game project folder of baidugame will be generated under the project's build directory, which already contains the configuration files of Baidu Mini Game's environment:
Use the Baidu Developer Tools to open the baidugame folder to preview and debug the game. About how to use Baidu Developer Tools, please refer to Baidu Developer Tools Documentation for details.
Note: When previewing and debugging, if a prompt appears stating:
The current version of the developer tool can't publish mini program, please update to the latest developer tools. This means the appid filled in the Build panel is the appid of the Baidu Mini Program, not the appid of the Baidu Mini Game, please re-apply for the appid of the Baidu Mini Game.
Resource Management for Baidu Mini Game Environment
Baidu Mini Game is similar to WeChat Mini Game. There are restrictions on the package size. Resources over 4MB must be downloaded via a network request.
We recommend that developers save only the script files in the package and download all other resources from the remote server. Cocos Creator already helps developers with downloading, caching and version management of remote resources. The specific implementation logic and operation steps are similar to the WeChat Mini game. Please refer to the Resource Management for WeChat Mini Game documentation for details.
Note: Currently, Baidu Mini Game only supports loading resources from remote server via HTTPS on the physical device, so the resource file must be placed on the HTTPS server, otherwise the resource loading failure will occur.
Baidu Mini Game Subpackage Loading
The subpackage loading method of Baidu Mini Game is similar to WeChat, with the following package restrictions:
- The size of all subpackage of the entire Mini Game can not exceed 8MB.
- The size of single subpackage / main package can not exceed 4MB.
Please refer to the SubPackage Loading for details.
Platform SDK Access
In addition to pure game content, the Baidu Mini Game environment also provides a very powerful native SDK interface, these interfaces are only exist in the Baidu Mini Game environment, equivalent to the third-party SDK interface of other platforms. The porting of such SDK interfaces still needs to be handled by developers at this stage. Here are some of the powerful SDK capabilities offered by Baidu Mini Game:
- User interface: login, authorization, user information, etc.
- Baidu cashier payment
- Forwarding information
- File upload and download
- Other: images, locations, ads, device information, etc.
Access to the Open Data Context of Baidu Mini Games
Similar to WeChat Mini Game, in order to protect its social relationship chain data, Baidu Mini Game also implements an Open Data Context, which can get friends information that is both playable and two-way attention. This is a separate game execution environment. The resources, engines, and programs in the Open Data Context are completely isolated from the main game. Developers can only access the
swan.getFriendCloudStorage() APIs provided by Baidu Mini Games in the Open Data Context, which are used to obtain the corresponding user data.
For details about the Baidu Mini Game Open Data Context process, please refer to Access Baidu Mini Game Open Data Context.
Baidu Mini Games known issues
Currently, the adaptation work of Baidu Mini Game is not completely finished, and the following components are not supported for the time being:
If needed, you can directly call Baidu's API as needed.