Along with the upgrading engine technology, HTML5 gaming has grown steadily in its industrial ecosystem, the number & quality of games as well as its market. Meanwhile, more and more game developers opt to build the hardcore, high-quality and multi-platform games.
The adoption of HTML5 technology not only ensures that the quality of game is compatible with native games but also increases revenue for game developers. Thus, the solution for packaging HTML5 game is a must-have feature in HTML5 engine.
Egretia Native, as one of main products, aims to enable developers to release game to multi-platform by one-click and simplify the method of game release. Egretia Native can power 2D game and 3D game with high efficiency in packaging and running performance.
Features:
Power 3D games and 3D/2D hybrid games
Egretia Native allows users to package 3D game developed by Egretia engine with high efficiency and power 2D&3D hybrid games by automatically optimizing the rendering. Its architecture and design ensure that game can run smoothly and rendering can be improved among plenty objects at same time.
2.Reduce the package size
There is concern about the package size of native game, except for the efficiency. Egretia Native reduces the package size without prejudice to the function and efficiency of game.
The size of empty project package is as follows:
IOS: ipa file 2.3M
Android: apk file 18.7M
Notably, Egretia Native supports three different CPU architectures in Android:
· ARM EABI
· ARM EABI-v7A
· x86
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
Egretia Coder is officially released! As a plugin for Egretia UI Editor, Egretia Coder functions as exml file code editor, an adaptor for Egretia UI Editor, the invocation of Egretia Engine and debugging, which helps developers boost the productivity in using EUI and VSCode.
It’s recommended that developers utilize VSCode as an integrated development environment (IDE). By default, VSCode has been used to access Egretia project automatically since Egretia Launcher 1.2.3.
Introduction of VSCode
Visual Studio Code (VS Code/VSC) is a lightweight and free code editor which is built on open source. It comes with supports for syntax highlighting and smart completions based on the mainstream programming languages, along with the extensions. It is optimized for both web development and cloud application development.
Introduction of Egretia Coder
Egretia Coder is a VSCode plugin for EUI project. Its features include, but not limited to:
>exml file code editing
>syntax highlighting
>smart completions
>hints
> snippets code
>formatting
> access a project in Egretia by invoking Egretia UI Editor
> call the compiling/cleanup/creation functions of Egretia Engine
>run and call project in Egretia
Setup
Local installation
1. Download the plugin and unzip the files
2. Open VSCODE
3. Open the extension page by clicking the icon on the sidebar
4. Click the view and more buttons on the upper right of the panel, and select installation from VSIX and then choose the local plug-in installation package to set up
5. Restart VSCODE
Get app from APP Store
Search and install Egretia Coder in the app store of VSCode
Features
Call Egretia UI Editor and open the directory
Menu > View > Command > Select the following command
Call Egretia engine
Menu> View > Command panel > select the following command
Or click the corresponding button on the status bar
Breakpoints debugging
INFO: Plugin will automatically detect whether the current folder is EUI (egretProperties.json) once it’s activated, then configure launch.json and tasks.json in ./vscode
1. Open a file of EUI project
2. Open ./scripts/config.ts file and make sure that build command has been deployed by the following content
const outputDir = ‘.’;
return {
outputDir,
commands: [
new ExmlPlugin(‘debug’), // 非 EUI 项目关闭此设置
new WebpackDevServerPlugin({ //新的 Webpack 编译器
libraryType: “debug”,
defines: { DEBUG: true, RELEASE: false },
typescript: { mode: ‘legacy’ },
open: false,
port: 3000
}),
]
}
Note: By default, the port number is 3000. Please revise uri of Egret WebpackDevServer Debugger in ./vscode/launch.json and the corresponding content in ./scripts/config.ts if you want to edit the port number.
3. Select Egret WebpackDevServer Debugger on the sidebar’s runtime panel, press F5 to debug. When you execute the breakpoint debugging in VSCode, the output information of browser console can be displayed on the debugging console simultaneously.
Run emmet in exml files editing
Find out Emmet: includeLanguages in the settings of VSCode, then edit the corresponding content to connect in setting.json
Add the following content in the popup panel: (run Emmet by xml)
“emmet.includeLanguages”: {
“exml”: “xml”
}
Keyboard shortcuts
The ‘cmd’ contained in the following table is key ‘ctrl’ in Windows
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
1)After the creation via Egretia Launcher, the project will be shown on the list. Then developers can click the release settings
2) Select the Xiaomi Quick Game to create the game
3) After the creation, developers can click the button to release the game
a. Compile the game code to Xiaomi Quick Game: to execute command egret build — target qgame and compile the code in the Egretia project into the Quick Game project;
b. QR code: to install rpk by scanning the QR code on the Xiaomi Quick Game Debugger
c. Release: to execute the command npm run build and build rpk package
d. Debugging: use the USB cable to connect your computer to the Xiaomi device and click the debug button then the debugging interface will start automatically in Chrome
3. Publish to Xiaomi Quick Game by the command line
Method 1: Developers can use the command line to build and release Xiaomi Quick Game
>debug: egretia build — target qgame;
>release: egretia publish — target qgame
Method 2: Deploy the template: egretProperties.json
As it shows, developers can execute the command line egretia build or egretia publish to build and release Xiaomi Quick Game when property current is set to qgame in the configuration files of egretProperties.json
4. Package and release Xiaomi Quick Game by the command line
1)Execute the command line npm run build and generate a dist file. The file com.application.demo.debug.rpk is the Quick Game Project file, which can be debugged on the devices.
2) Generate the Quick Game to be released by executing the command line
npm run release
3) Listed below is the Quick Game structure
4) An overview of directory structure:
egret.qgame.js: Adaptation layer code of Egretia engine and Quick Game;
js folder: js code of the game;
library:the code of local cache of running Xiaomi Quick Game by Assetsmanager can be deleted;
main.js:the entry file of Quick Game;
manifest.js: to load all js codes;
manifest.json: the configuration file of Quick Game
resources: resource files such as pictures and audio of the game
5) manifest.json
6) Parameter:
Package: the name of package;
Name: Application name, within 6 Chinese characters, consistent with the name saved in the application store, used to display the application name on desktop icons, pop-up windows, etc.;
versionName: the application version;
versionCode: The application version number, which is incremented from 1. It is recommended to add 1 to the current version every time the package is re-uploaded;
minPlatformVersion: The minimum supported platform version number (1041), for compatibility check, can avoid the incompatibility caused by running on low version platforms after going online; if not filled in, it will be processed according to the internal test version;
icon: The path of the application icon, the size is 192×192;
orientation: the Supported screen orientation. Portrait is vertical screen, and landscape is horizontal screen. This parameter will be automatically obtained from index.html of the Egretia game project.
4. Debugging
Note: The debugging must be based on the physical device.
1) Install Xiaomi Quick Game Debugger and Xiaomi Quick Game Environment
2) Use a USB cable to connect your computer to your Xiaomi device and copy the generated quick game rpk file to the devices
3) Open the Xiaomi Quick Game Debugger, choose (com.miui.hybrid) and click Local Install, then select the uploaded rpk files to run the game
4) Input chrome://inspect/#devices on the Chrome browser and click Enter to generate com.miui.hybrid. the debugging information will pop out on the screen
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
As Taobao Mini Program goes mainstream, brand owners have a growing need to increase their brand value and gain more users and market share through Alibaba. As such, Egretia engine allows developers to launch the game on Taobao quickly.
Development procedure for accessing Taobao Mini Program
1. Preparation
> Register a retailer account on Taobao
> Download Taobao toolkit
> Call APIs such as game sign-in and user information provided by Taobao
> Egretia engine V5.3.10 or above
> Egretia Launcher V1.2.22 or above
2. The game creation and package
1)Create a game via Egretia Launcher or import the existing project on Egretia
2) After creating or importing is done, it will be shown on the list. Then developers can click the release settings
3) Select Taobao Mini Program to create the game
4) After the creation, developers can click the button to release the game
5) The type of game code: compile the code in the Egretia project into Taobao project;
• debug: js code is not obfuscated by uglify, which is convenient for debugging;
release: the uglify obfuscation and compression for js code;
6) Taobao Mini Program structure:
· app.css :files of application, no modification in general
· app.js:register app, to receive the notification of running, display and hiding
· app.json:the configuration file
· js directory:js code of game
· manifest.js:to load dependent js files
· mini.project.json:to configure the files format.(set the special format here)
· package.json:description file
· pages/index files:
· egret.tbgame.js:Adaptation layer code of Egretia
· index.axml:the page of entry
· index.js:entry files
· tools files:tools (no editing)
· resource : resource files such as pictures and audio of the game
3. Download and install
• Download the toolkit
Click to select the app for retailer, and then install it on the phone
• Select the application
Associate the application on the upper left and click the real-device test on the upper right. After the compilation is completed, please scan the code for debugging via Taobao mobile APP
4. Notes
1). Due to security issues, the platform does not support the API of my.request network request. However, it supports most of the network request methods through other APIs. If you still have problems with your game, please use cloud development
2). When loading remote resources, the resources must be placed under the domain name of Ali, please consult Taobao’s technical support for details;
3). The text input function provided by the platform is very weak, please test first to check the effect;
4). The created egret.Sound must be destroyed by calling the sound.close() method when it’s not in use;
5). Horizontal screen games is not available;
6). iOS does not support websock real-device debugging, but preview mode can be used;
7). iOS does not support local sound playback for the time being, and the sound loaded on the network is available;
8). You cannot directly call the window object without $global.window;
9). The emulator does not support functions such as sound playback, please refer to the real-device test.
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
The new version of Egretia engine is officially released to fix bugs and improve performance. We’ve fixed system stuck issue as well as the problem of htmlsound returns and DragonBones.
If you skip the upgrade to the latest version of engine, here’s how to get its features.
Method 1: WebGLVertexArrayObject.ts.cacheArrays
Method 2: WebGLRenderContext.ts.drawTexture
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
Please note that developers should use EgretiapPro at Version 1.6 or above and Egretia2d engine at Version 5.3.7 or above
Create a project
Firstly, open EgretiaPro, then click Project>Library Project>Create
After the creation, EgretiaPro will automatically open the library project RunningGame which was just created. Then create a RunningScene under the directory of resource/scenes and double-click to open the scene in the scene editor. As shown below:
Create tracks
The track is spliced by three entity Cubes, and the track needs to roll up as the protagonist runs forward. Here we create the track dynamically through components. Use Vscode to open the project you just created, then create a folder game under the src directory to store our component code, and then create the RoadController.ts file in the game directory.
Then add the RoadController component to the Root entity of the scene.
Now click the preview (built-in) (or preview browser) button, and you can see the following effect.
If it looks a bit weird, you can adjust the position and angle of the camera by debugging the camera’s TransForm parameters in the running interface to make the picture look more comfortable.
Add protagonist
Add the protagonist to the scene and let him run forward, as follows:
The first step is to copy the game material BakedAnimation to the project directory resource/assets/a nimations.
In the second step, open the resource/assets/animations/BakedAni mation/Boy_standby_out directory in the EgretiaPro editor explorer, drag and drop the Boy_standby.gltf.prefab.json file into the scene.
The third step is to play the running animation of the protagonist. There are two ways: Method 1: Directly operate in the pro editor. details as follows:
Method 2: Uncheck autoPlay in the pro editor and implement it through scripts. Create a PlayerController file under the game directory; (Remember to hang the PlayerController component on the protagonist entity).
As of now, the protagonist is running on the track. But the player is supposed to move forward. As such, we need to constantly update the position of the protagonist in the onUpdate function and meanwhile make the camera move along with the protagonist at the same speed. Otherwise you will find that your protagonist runs further and further on your screen, getting smaller and smaller.
As the protagonist moves forward, we find that the track under his feet is gone. What we need to do now is to open RoadController.ts component then continue to pave the road while the protagonist moves forward.
Then use the left mouse button to control the protagonist’s movement direction. To change the position of the protagonist by the onUpdate function according to the movement of the mouse.
Add coins
A prefab is a collection of game objects and their components. The purpose is to enable game objects and resources to be reused. The same game object can be created through a prefab. This process can be understood as instantiation. Since the gold coins in the game are scattered all over the runway, it is perfect to make gold coins by prefabs!
How to create a prefab:
1. Open (or create) the resource/perfab directory, and then right-click — “Create prefab coin.perfab.json in the resource manager module;
2. Double-click the prefab just created, right-click in the hierarchy bar → 3D →Sphere;
3. Select the sphere you just created, and select the material item in the property bar, select coin.mat.json.
First, let’s get started with a coin component Coin.ts
Our gold coins are scattered on the runway, so every time we create a runway, we randomly create some gold coins on the runway. The number of gold coins and location are random. Next, you need to add the following logic code to the RoadController.ts component:
Now a lot of gold coins are scattered on the road. But it’s necessary to build a gold coin pool to collect gold coins instead of creating gold coins all the time. So Next we will create a gold coin buffer pool. Add a CoinPool class to the Coin.ts file.
When the gold coin leaves the rendering range of the camera, we should put the gold coin into the buffer pool, and the gold coin entity is not participating in the rendering, so that the gold coin is in a dormant state. We put these processing of gold coins in the system class to do. The system is a tool to handle a collection of entities with one or more identical characteristic components, which only have behavior (that is, there is no state in the system). How to get all the gold coins in our system class?The entity matcher is used to define the rules of a set of entities with certain component characteristics. A clear set of rules can be defined through an instance of the matcher.
In our cases, we first create a gold coin system class CoinSystem.ts in which all the gold coins are collected, and then check whether the gold coins are thrown behind by the player and no need to render in each frame, then those will be returned to the gold coin pool. Look specifically at the following code:
The system does not work like a component directly added to the entity so we need to register the system with the component. Next, add the following two lines of code in PlayerController
We will consider getting them from the buffer pool first when it comes to the creation of gold coins. Modify the crea teCoins() function in RoadController.ts.
The collision
Next, what we must do is to deal with the collision between the gold coin and the protagonist. We need to check each gold coin. If there is a collision with the protagonist, then the gold coin will have an easing animation and then disappear. Thus we still put the behavior of dealing with the collision between gold coins and the protagonist in the CoinSystem.ts system class.
Add UI interface
As of now, 3D scene is complete. Next, we need to add a UI interface to the case, that is, to add some 2d content. Here is an explanation of how to add a UI interface in a 3d scene. The integration of Egretia2d and EgretiaPro. Firstly, to export the 3d scene into a third-party library pro-library; Secondly, to create a 2d project and add the third library pro-library to the 2d project; Thirdly, to upgrade the 2D project and modify index.html.
Lastly, the scene in EgretiaPro is rendered as an Egretia.Texture object. Add Egretia.Texture to the Bitmap object so as to render to the stage through Egretia engine.
After the first three steps, the project directory is as follows:
Then we click the start button to add a parkour scene. See the Main.ts file for details
.But at this time, you may find that the protagonist could not move towards left or right side. What we need to do now is to pass on the 2d touch event to the 3d scene. Then you need to complete the communication through Egretia.pro
Then we need to receive and process the message in the PlayerController of the 3d scene. Details as below:
Now, enter the command in the console: Egretia run -a and run your project!
What are the coolest projects you saw from people using Egretia Pro?
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
Development procedure for accessing the Huawei Quick Game:
1. Preparation
>Register as a developer on Huawei Quick Game
>Call APIs such as game sign-in and user information provided by Huawei
> Note that the size of released rpk file is less than 10MB
2. The game creation and package
1)Create a game via Egretia Launcher or import the existing project on Egretia
2) After creating or importing is done, it will be shown on the list. Then developers can click the release settings
3) Select the Huawei Quick Game to create the quick game
4) After the creation, developers can click the button to release the game
Compile the game code to Huawei Quick Game: compile the code in the Egretia project into the Quick Game project;
• The type of game code -debug: js code is not obfuscated by uglify, which is convenient for debugging;
The type of game code -release: the uglify obfuscation and compression for js code;
5) After release, the rpk files will be generated in dist files
6) Huawei Quick Game Structure
• Build directory:
o egret.fastgame.js: Adaptation layer code of Egretia engine and Quick Game;
o game.js: the entry file of Quick Game;
o icon directory: game icons;
o js directory: js code of the game;
o manifest.js: to load dependent js files;
o manifest.json: the configuration file of Quick Game
o resources: resource files such as pictures and audio of the game;
o dist directory: to store compiled rpk files;
o sign: to store signature files;
o signtool: a compilation tool for Quick Game;
7) Through the “Modify Configuration” tab of the Launcher, developers can modify the relevant parameters of Huawei quick game
• Note that developers need to republish the rpk for the new parameters to take effect after modifying the parameters;
The minimum platform version number is 1075;
3. Download and install Huawei Quick App Loader
• Download the Windows/Mac version of the Quick Application Loader Assistant;
Click to select the compiled rpk package, and then install it on the phone
4. About signature files
There are two types of the signature of Huawei Quick Game: debug and release. We provide a default debug signature for developers to package and debug. But if developers want to use platform functions such as log-in and user information, they must use the release signature.
• On the release tab of the Launcher, developers can select Release as the signature type, and click the “Open” button on the right to open a folder, and then import the generated signature file;
• After re-release, the generated rpk package is signed with release;
Note: For signatures generated by Huawei tools, the fingerprint of the certificate must be filled in the project settings in the background of Quick Game.
To execute, developers shall use the latest version of Egretia engine and Egretia Launcher
Egretia Compiler
In this case, developers only need to install the latest version of Launcher and download Egretia Compiler in the [Tools] tab, which can be used more easily without executing the npm install command in each project.
Besides, here is an update on webpack:
• legacy mode
o Fix the decorator sorting problem;
o Fix the error of namespace;
o Fix the problem that the global enumeration cannot be accessed;
o Add sourcemap;
o Fix the compilation error caused by .d.ts in the src folder;
o Modify the .ts matching rules in legacy mode and adopt the configuration in tsconfig.json instead of hard-coded the src folder;
• Linux platform support;
• Fix the problem that Egretia.is returns incorrect results after compilation;
• Optimize the output volume which has been reduced about 20%
• Add typescript.tsconfigPath;
Egretia UI Editor
• Add right click to resource library -> copy resource name;
• Exml source code supports formatting;
• Support drag the skin by pressing the right button;
• The resource manager supports deleting files through the Delete key;
• The right-click menu item displays the corresponding shortcut keys;
• The interface can be zoomed by the mouse wheel in the preview state;
• Adjust the step length of the size & position part of the attribute item to 1, which is more user-friendly;
•To change the shortcut skin of Button by dragging and dropping resources to the input box
• The custom components are sorted alphabetically for easy search;
• The component frame is drawn by canvas, and the skin editing is smoother;
• Fix that clicking may cause the component level to be changed in some cases
• Fix that frequent changes to the component location may cause the editor to crash;
• Fix the issue that the list in the Ctrl+P shortcut to open the file is not updated synchronously after the file is changed
• Fix the problem that the interface is not updated in real time after changing the component skin;
Document
• Optimize the page loading speed from an average of 2 seconds to an average of 300 milliseconds
• Upload multiple documents and remove some outdated documents
All the sample codes in the document are written in ES2015 version, e.g. declare Variables with let and const
Stay tuned for updates from the Egretia official channels below so that you can be involved in all the exciting things to come!
// add the loading interface to scene this.stage.addChild(this.main.loadingView); //read the resources await RES.loadGroup(“game”, 0, this.main.loadingView); //remove the interface this.stage.removeChild(this.main.loadingView);
>Add the images in interfaces
Create LoadingUI2
Main
loadResource()
this.loadingView = new LoadingUI2();
MainMenu
> Singleton Pattern and Create JSON
An implementation of the singleton pattern must:
ensure that only one instance of the singleton class ever exists;
and provide global access to that instance.
JSON is an open standard file format, and data interchange format, that uses human-readable text to store and transmit data objects consisting of attribute–value pairs and array data types (or any other serializable value). It is a language-independent data format and a very common data format, with a diverse range of applications.
> Basic concepts of game design and game development:Separate data and logic
//shoot once every pass of main loop, the distance is 80
this.vy = -80; //-80 upwards
this.vx = 0 ;
this.dx = this.dy = 0 ;
this.n = 0;
break;
update():
//the special one will be scheduled in advance and automatically executed. The “return” will show up when it finishes.
if(this.id == 10){
//the distances between planes and them
this.dx +=this.vx;
this.dy +=this.vy;
//offset value:base value+offset
// coordinates of laser is base coordinates and changes
this.x = this.game.player.x + this.dx;
this.y = this.game.player.y + this.dy;
// test whether it’s off-screen
if(this.y < -100 ){
this.vis = false;
}
return;
}
>Tracking bullet
Demonstration
Version:1.0
StartHTML:000000275
EndHTML:000053955
StartFragment:000021508
EndFragment:000053873
StartSelection:000021508
EndSelection:000053869
SourceURL:https://medium.com/egretia/create-a-space-shooter-game-egretia-engine-tutorial-for-beginners-part-6-a93d80fc08de
Create A Space Shooter Game | Egretia Engine Tutorial For Beginners Part 6 | by Egretia Io | Egretia | Aug, 2020 | Medium
1)NPC:
NPCManager
//obtain NPC
public getNPC():NPC{
//length>0,NPC exists; if no, bounce off
if(this.nm.length > 0 ){
//if there is npc, choose one randomly
let npc = this.nm[Math.floor(Math.random()* this.nm.length)]