2023-03-09 09:41:52 +01:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-07-06 10:08:05 +02:00
<class name= "EditorExportPlatformWeb" inherits= "EditorExportPlatform" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2023-03-09 09:41:52 +01:00
<brief_description >
Exporter for the Web.
</brief_description>
<description >
2024-01-08 22:57:26 +01:00
The Web exporter customizes how a web build is handled. In the editor's "Export" window, it is created when adding a new "Web" preset.
[b]Note:[/b] Godot on Web is rendered inside a [code]< canvas> [/code] tag. Normally, the canvas cannot be positioned or resized manually, but otherwise acts as the main [Window] of the application.
2023-03-09 09:41:52 +01:00
</description>
<tutorials >
<link title= "Exporting for the Web" > $DOCS_URL/tutorials/export/exporting_for_web.html</link>
2023-08-15 12:14:01 +02:00
<link title= "Web documentation index" > $DOCS_URL/tutorials/platform/web/index.html</link>
2023-03-09 09:41:52 +01:00
</tutorials>
<members >
<member name= "custom_template/debug" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
File path to the custom export template used for debug builds. If left empty, the default template is used.
2023-03-09 09:41:52 +01:00
</member>
<member name= "custom_template/release" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
File path to the custom export template used for release builds. If left empty, the default template is used.
2023-03-09 09:41:52 +01:00
</member>
<member name= "html/canvas_resize_policy" type= "int" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
Determines how the canvas should be resized by Godot.
- [b]None:[/b] The canvas is not automatically resized.
- [b]Project:[/b] The size of the canvas is dependent on the [ProjectSettings].
- [b]Adaptive:[/b] The canvas is automatically resized to fit as much of the web page as possible.
2023-03-09 09:41:52 +01:00
</member>
<member name= "html/custom_html_shell" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
The custom HTML page that wraps the exported web build. If left empty, the default HTML shell is used.
For more information, see the [url=$DOCS_URL/tutorials/platform/web/customizing_html5_shell.html]Customizing HTML5 Shell[/url] tutorial.
2023-03-09 09:41:52 +01:00
</member>
<member name= "html/experimental_virtual_keyboard" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code], embeds support for a virtual keyboard into the web page, which is shown when necessary on touchscreen devices.
[b]Warning:[/b] This feature is experimental and may be changed in a future release.
2023-03-09 09:41:52 +01:00
</member>
<member name= "html/export_icon" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code], the project icon will be used as the favicon for this application's web page.
2023-03-09 09:41:52 +01:00
</member>
<member name= "html/focus_canvas_on_start" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code], the canvas will be focused as soon as the application is loaded, if the browser window is already in focus.
2023-03-09 09:41:52 +01:00
</member>
<member name= "html/head_include" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
Additional HTML tags to include inside the [code]< head> [/code], such as [code]< meta> [/code] tags.
[b]Note:[/b] You do not need to add a [code]< title> [/code] tag, as it is automatically included based on the project's name.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/background_color" type= "Color" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
The background color used behind the web application.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/display" type= "int" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
The [url=https://developer.mozilla.org/en-US/docs/Web/Manifest/display/]display mode[/url] to use for this progressive web application. Different browsers and platforms may not behave the same.
- [b]Fullscreen:[/b] Displays the app in fullscreen and hides all of the browser's UI elements.
- [b]Standalone:[/b] Displays the app in a separate window and hides all of the browser's UI elements.
- [b]Minimal UI:[/b] Displays the app in a separate window and only shows the browser's UI elements for navigation.
- [b]Browser:[/b] Displays the app as a normal web page.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/enabled" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code], turns this web build into a [url=https://en.wikipedia.org/wiki/Progressive_web_app]progressive web application[/url] (PWA).
2023-03-09 09:41:52 +01:00
</member>
2023-12-12 21:39:25 +01:00
<member name= "progressive_web_app/ensure_cross_origin_isolation_headers" type= "bool" setter= "" getter= "" >
When enabled, the progressive web app will make sure that each request has cross-origin isolation headers (COEP/COOP).
This can simplify the setup to serve the exported game.
</member>
2023-03-09 09:41:52 +01:00
<member name= "progressive_web_app/icon_144x144" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
File path to the smallest icon for this web application. If not defined, defaults to the project icon.
[b]Note:[/b] If the icon is not 144x144, it will be automatically resized for the final build.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/icon_180x180" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
File path to the small icon for this web application. If not defined, defaults to the project icon.
[b]Note:[/b] If the icon is not 180x180, it will be automatically resized for the final build.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/icon_512x512" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
File path to the smallest icon for this web application. If not defined, defaults to the project icon.
[b]Note:[/b] If the icon is not 512x512, it will be automatically resized for the final build.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/offline_page" type= "String" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
The page to display, should the server hosting the page not be available. This page is saved in the client's machine.
2023-03-09 09:41:52 +01:00
</member>
<member name= "progressive_web_app/orientation" type= "int" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
The orientation to use when the web application is run through a mobile device.
- [b]Any:[/b] No orientation is forced.
- [b]Landscape:[/b] Forces a horizontal layout (wider than it is taller).
- [b]Portrait:[/b] Forces a vertical layout (taller than it is wider).
2023-03-09 09:41:52 +01:00
</member>
<member name= "variant/extensions_support" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code] enables [GDExtension] support for this web build.
2023-03-09 09:41:52 +01:00
</member>
2023-12-01 19:39:09 +01:00
<member name= "variant/thread_support" type= "bool" setter= "" getter= "" >
If enabled, the exported game will support threads. It requires [url=https://web.dev/articles/coop-coep]a "cross-origin isolated" website[/url], which can be difficult to setup and brings some limitations (e.g. not being able to communicate with third-party websites).
If disabled, the exported game will not support threads. As a result, it is more prone to performance and audio issues, but will only require to be run on a HTTPS website.
</member>
2023-03-09 09:41:52 +01:00
<member name= "vram_texture_compression/for_desktop" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code], allows textures to be optimized for desktop through the S3TC algorithm.
2023-03-09 09:41:52 +01:00
</member>
<member name= "vram_texture_compression/for_mobile" type= "bool" setter= "" getter= "" >
2024-01-08 22:57:26 +01:00
If [code]true[/code] allows textures to be optimized for mobile through the ETC2 algorithm.
2023-03-09 09:41:52 +01:00
</member>
</members>
</class>