EditorExportPlatformWeb.xml 6.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="EditorExportPlatformWeb" inherits="EditorExportPlatform" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
  3. <brief_description>
  4. Exporter for the Web.
  5. </brief_description>
  6. <description>
  7. 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.
  8. [b]Note:[/b] Godot on Web is rendered inside a [code]&lt;canvas&gt;[/code] tag. Normally, the canvas cannot be positioned or resized manually, but otherwise acts as the main [Window] of the application.
  9. </description>
  10. <tutorials>
  11. <link title="Exporting for the Web">$DOCS_URL/tutorials/export/exporting_for_web.html</link>
  12. <link title="Web documentation index">$DOCS_URL/tutorials/platform/web/index.html</link>
  13. </tutorials>
  14. <members>
  15. <member name="custom_template/debug" type="String" setter="" getter="">
  16. File path to the custom export template used for debug builds. If left empty, the default template is used.
  17. </member>
  18. <member name="custom_template/release" type="String" setter="" getter="">
  19. File path to the custom export template used for release builds. If left empty, the default template is used.
  20. </member>
  21. <member name="html/canvas_resize_policy" type="int" setter="" getter="">
  22. Determines how the canvas should be resized by Godot.
  23. - [b]None:[/b] The canvas is not automatically resized.
  24. - [b]Project:[/b] The size of the canvas is dependent on the [ProjectSettings].
  25. - [b]Adaptive:[/b] The canvas is automatically resized to fit as much of the web page as possible.
  26. </member>
  27. <member name="html/custom_html_shell" type="String" setter="" getter="">
  28. The custom HTML page that wraps the exported web build. If left empty, the default HTML shell is used.
  29. For more information, see the [url=$DOCS_URL/tutorials/platform/web/customizing_html5_shell.html]Customizing HTML5 Shell[/url] tutorial.
  30. </member>
  31. <member name="html/experimental_virtual_keyboard" type="bool" setter="" getter="">
  32. If [code]true[/code], embeds support for a virtual keyboard into the web page, which is shown when necessary on touchscreen devices.
  33. [b]Warning:[/b] This feature is experimental and may be changed in a future release.
  34. </member>
  35. <member name="html/export_icon" type="bool" setter="" getter="">
  36. If [code]true[/code], the project icon will be used as the favicon for this application's web page.
  37. </member>
  38. <member name="html/focus_canvas_on_start" type="bool" setter="" getter="">
  39. If [code]true[/code], the canvas will be focused as soon as the application is loaded, if the browser window is already in focus.
  40. </member>
  41. <member name="html/head_include" type="String" setter="" getter="">
  42. Additional HTML tags to include inside the [code]&lt;head&gt;[/code], such as [code]&lt;meta&gt;[/code] tags.
  43. [b]Note:[/b] You do not need to add a [code]&lt;title&gt;[/code] tag, as it is automatically included based on the project's name.
  44. </member>
  45. <member name="progressive_web_app/background_color" type="Color" setter="" getter="">
  46. The background color used behind the web application.
  47. </member>
  48. <member name="progressive_web_app/display" type="int" setter="" getter="">
  49. 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.
  50. - [b]Fullscreen:[/b] Displays the app in fullscreen and hides all of the browser's UI elements.
  51. - [b]Standalone:[/b] Displays the app in a separate window and hides all of the browser's UI elements.
  52. - [b]Minimal UI:[/b] Displays the app in a separate window and only shows the browser's UI elements for navigation.
  53. - [b]Browser:[/b] Displays the app as a normal web page.
  54. </member>
  55. <member name="progressive_web_app/enabled" type="bool" setter="" getter="">
  56. If [code]true[/code], turns this web build into a [url=https://en.wikipedia.org/wiki/Progressive_web_app]progressive web application[/url] (PWA).
  57. </member>
  58. <member name="progressive_web_app/ensure_cross_origin_isolation_headers" type="bool" setter="" getter="">
  59. When enabled, the progressive web app will make sure that each request has cross-origin isolation headers (COEP/COOP).
  60. This can simplify the setup to serve the exported game.
  61. </member>
  62. <member name="progressive_web_app/icon_144x144" type="String" setter="" getter="">
  63. File path to the smallest icon for this web application. If not defined, defaults to the project icon.
  64. [b]Note:[/b] If the icon is not 144x144, it will be automatically resized for the final build.
  65. </member>
  66. <member name="progressive_web_app/icon_180x180" type="String" setter="" getter="">
  67. File path to the small icon for this web application. If not defined, defaults to the project icon.
  68. [b]Note:[/b] If the icon is not 180x180, it will be automatically resized for the final build.
  69. </member>
  70. <member name="progressive_web_app/icon_512x512" type="String" setter="" getter="">
  71. File path to the smallest icon for this web application. If not defined, defaults to the project icon.
  72. [b]Note:[/b] If the icon is not 512x512, it will be automatically resized for the final build.
  73. </member>
  74. <member name="progressive_web_app/offline_page" type="String" setter="" getter="">
  75. The page to display, should the server hosting the page not be available. This page is saved in the client's machine.
  76. </member>
  77. <member name="progressive_web_app/orientation" type="int" setter="" getter="">
  78. The orientation to use when the web application is run through a mobile device.
  79. - [b]Any:[/b] No orientation is forced.
  80. - [b]Landscape:[/b] Forces a horizontal layout (wider than it is taller).
  81. - [b]Portrait:[/b] Forces a vertical layout (taller than it is wider).
  82. </member>
  83. <member name="variant/extensions_support" type="bool" setter="" getter="">
  84. If [code]true[/code] enables [GDExtension] support for this web build.
  85. </member>
  86. <member name="variant/thread_support" type="bool" setter="" getter="">
  87. 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).
  88. 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.
  89. </member>
  90. <member name="vram_texture_compression/for_desktop" type="bool" setter="" getter="">
  91. If [code]true[/code], allows textures to be optimized for desktop through the S3TC algorithm.
  92. </member>
  93. <member name="vram_texture_compression/for_mobile" type="bool" setter="" getter="">
  94. If [code]true[/code] allows textures to be optimized for mobile through the ETC2 algorithm.
  95. </member>
  96. </members>
  97. </class>