Files
godot-docs-l10n/classes/it/class_editorexportplatformweb.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

416 lines
24 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_EditorExportPlatformWeb:
EditorExportPlatformWeb
=======================
**Eredita:** :ref:`EditorExportPlatform<class_EditorExportPlatform>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
Esportatore per il Web.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
L'esportatore Web personalizza il modo in cui viene gestita una build Web. Nella finestra "Esporta" dell'editor, viene creato quando si aggiunge un nuovo preset "Web".
\ **Nota:** Godot su Web viene renderizzato all'interno di un tag ``<canvas>``. Normalmente, il canvas non può essere posizionato o ridimensionato manualmente, ma altrimenti funge da :ref:`Window<class_Window>` principale dell'applicazione.
.. rst-class:: classref-introduction-group
Tutorial
----------------
- :doc:`Esportazione per il Web <../tutorials/export/exporting_for_web>`
- :doc:`Indice della documentazione Web <../tutorials/platform/web/index>`
.. rst-class:: classref-reftable-group
Proprietà
------------------
.. table::
:widths: auto
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`custom_template/debug<class_EditorExportPlatformWeb_property_custom_template/debug>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`custom_template/release<class_EditorExportPlatformWeb_property_custom_template/release>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`html/canvas_resize_policy<class_EditorExportPlatformWeb_property_html/canvas_resize_policy>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`html/custom_html_shell<class_EditorExportPlatformWeb_property_html/custom_html_shell>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`html/experimental_virtual_keyboard<class_EditorExportPlatformWeb_property_html/experimental_virtual_keyboard>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`html/export_icon<class_EditorExportPlatformWeb_property_html/export_icon>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`html/focus_canvas_on_start<class_EditorExportPlatformWeb_property_html/focus_canvas_on_start>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`html/head_include<class_EditorExportPlatformWeb_property_html/head_include>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Color<class_Color>` | :ref:`progressive_web_app/background_color<class_EditorExportPlatformWeb_property_progressive_web_app/background_color>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`progressive_web_app/display<class_EditorExportPlatformWeb_property_progressive_web_app/display>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`progressive_web_app/enabled<class_EditorExportPlatformWeb_property_progressive_web_app/enabled>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`progressive_web_app/ensure_cross_origin_isolation_headers<class_EditorExportPlatformWeb_property_progressive_web_app/ensure_cross_origin_isolation_headers>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`progressive_web_app/icon_144x144<class_EditorExportPlatformWeb_property_progressive_web_app/icon_144x144>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`progressive_web_app/icon_180x180<class_EditorExportPlatformWeb_property_progressive_web_app/icon_180x180>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`progressive_web_app/icon_512x512<class_EditorExportPlatformWeb_property_progressive_web_app/icon_512x512>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`progressive_web_app/offline_page<class_EditorExportPlatformWeb_property_progressive_web_app/offline_page>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`progressive_web_app/orientation<class_EditorExportPlatformWeb_property_progressive_web_app/orientation>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`threads/emscripten_pool_size<class_EditorExportPlatformWeb_property_threads/emscripten_pool_size>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`threads/godot_pool_size<class_EditorExportPlatformWeb_property_threads/godot_pool_size>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`variant/extensions_support<class_EditorExportPlatformWeb_property_variant/extensions_support>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`variant/thread_support<class_EditorExportPlatformWeb_property_variant/thread_support>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`vram_texture_compression/for_desktop<class_EditorExportPlatformWeb_property_vram_texture_compression/for_desktop>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`vram_texture_compression/for_mobile<class_EditorExportPlatformWeb_property_vram_texture_compression/for_mobile>` |
+-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà
------------------------------------------------------
.. _class_EditorExportPlatformWeb_property_custom_template/debug:
.. rst-class:: classref-property
:ref:`String<class_String>` **custom_template/debug** :ref:`🔗<class_EditorExportPlatformWeb_property_custom_template/debug>`
Percorso file per il modello di esportazione personalizzato utilizzato per le build di debug. Se lasciato vuoto, viene utilizzato il modello predefinito.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_custom_template/release:
.. rst-class:: classref-property
:ref:`String<class_String>` **custom_template/release** :ref:`🔗<class_EditorExportPlatformWeb_property_custom_template/release>`
Percorso file per il modello di esportazione personalizzato utilizzato per le build di rilascio. Se lasciato vuoto, viene utilizzato il modello predefinito.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_html/canvas_resize_policy:
.. rst-class:: classref-property
:ref:`int<class_int>` **html/canvas_resize_policy** :ref:`🔗<class_EditorExportPlatformWeb_property_html/canvas_resize_policy>`
Determina come il canvas deve essere ridimensionato da Godot.
- **None:** Il canvas non viene ridimensionato automaticamente.
- **Project:** Le dimensioni del canvas dipende da :ref:`ProjectSettings<class_ProjectSettings>`.
- **Adaptive:** Il canvas viene ridimensionato automaticamente per adattarsi il più possibile alla pagina web.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_html/custom_html_shell:
.. rst-class:: classref-property
:ref:`String<class_String>` **html/custom_html_shell** :ref:`🔗<class_EditorExportPlatformWeb_property_html/custom_html_shell>`
La pagina HTML personalizzata che racchiude la build web esportata. Se lasciata vuota, viene utilizzata la shell HTML predefinita.
Per ulteriori informazioni, vedi il tutorial :doc:`Personalizzazione della shell HTML5 <../tutorials/platform/web/customizing_html5_shell>`.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_html/experimental_virtual_keyboard:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **html/experimental_virtual_keyboard** :ref:`🔗<class_EditorExportPlatformWeb_property_html/experimental_virtual_keyboard>`
**Sperimentale:** Questa proprietà potrebbe essere cambiata o rimossa in versioni future.
Se ``true``, incorpora il supporto per una tastiera virtuale nella pagina web, che viene visualizzata quando necessario sui dispositivi touchscreen.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_html/export_icon:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **html/export_icon** :ref:`🔗<class_EditorExportPlatformWeb_property_html/export_icon>`
Se ``true``, l'icona del progetto verrà utilizzata come favicon per la pagina web di questa applicazione.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_html/focus_canvas_on_start:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **html/focus_canvas_on_start** :ref:`🔗<class_EditorExportPlatformWeb_property_html/focus_canvas_on_start>`
Se ``true``, il canvas sarà focalizzato non appena l'applicazione è caricata, se la finestra del browser è già in focus.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_html/head_include:
.. rst-class:: classref-property
:ref:`String<class_String>` **html/head_include** :ref:`🔗<class_EditorExportPlatformWeb_property_html/head_include>`
I tag HTML aggiuntivi da includere all'interno di ``<head>``, come i tag ``<meta>``.
\ **Nota:** non è necessario aggiungere un tag ``<title>``, poiché viene incluso automaticamente in base al nome del progetto.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/background_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **progressive_web_app/background_color** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/background_color>`
Il colore di sfondo utilizzato dietro l'applicazione web.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/display:
.. rst-class:: classref-property
:ref:`int<class_int>` **progressive_web_app/display** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/display>`
La `modalità di visualizzazione <https://developer.mozilla.org/en-US/docs/Web/Manifest/display/>`__ da utilizzare per questa applicazione web progressiva. Browser e piattaforme diversi potrebbero non comportarsi allo stesso modo.
- **Fullscreen:** Visualizza l'app a schermo intero e nasconde tutti gli elementi dell'UI del browser.
- **Standalone:** Visualizza l'app in una finestra separata e nasconde tutti gli elementi dell'UI del browser.
- **Minimal UI:** Visualizza l'app in una finestra separata e mostra solo gli elementi dell'UI del browser per la navigazione.
- **Browser:** Visualizza l'app come una normale pagina web.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **progressive_web_app/enabled** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/enabled>`
Se ``true``, trasforma questa web build in una `applicazione web progressiva <https://it.wikipedia.org/wiki/Progressive_Web_App>`__ (PWA).
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/ensure_cross_origin_isolation_headers:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **progressive_web_app/ensure_cross_origin_isolation_headers** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/ensure_cross_origin_isolation_headers>`
Se abilitata, l'applicazione web progressiva si assicurerà che ogni richiesta abbia intestazioni di isolamento cross-origin (COEP/COOP).
Ciò può semplificare la configurazione per servire il gioco esportato.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/icon_144x144:
.. rst-class:: classref-property
:ref:`String<class_String>` **progressive_web_app/icon_144x144** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/icon_144x144>`
Percorso del file dell'icona più piccola per questa applicazione web. Se non definito, il valore predefinito è l'icona del progetto.
\ **Nota:** Se l'icona non è 144×144, verrà ridimensionata automaticamente per la build finale.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/icon_180x180:
.. rst-class:: classref-property
:ref:`String<class_String>` **progressive_web_app/icon_180x180** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/icon_180x180>`
Percorso del file dell'icona piccola per questa applicazione web. Se non definito, il valore predefinito è l'icona del progetto.
\ **Nota:** Se l'icona non è 180×180, verrà ridimensionata automaticamente per la build finale.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/icon_512x512:
.. rst-class:: classref-property
:ref:`String<class_String>` **progressive_web_app/icon_512x512** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/icon_512x512>`
Percorso del file dell'icona normale per questa applicazione web. Se non definito, il valore predefinito è l'icona del progetto.
\ **Nota:** se l'icona non è 512×512, verrà ridimensionata automaticamente per la build finale.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/offline_page:
.. rst-class:: classref-property
:ref:`String<class_String>` **progressive_web_app/offline_page** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/offline_page>`
La pagina da visualizzare, qualora il server che ospita la pagina non fosse disponibile. Questa pagina è salvata nella macchina del client.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_progressive_web_app/orientation:
.. rst-class:: classref-property
:ref:`int<class_int>` **progressive_web_app/orientation** :ref:`🔗<class_EditorExportPlatformWeb_property_progressive_web_app/orientation>`
Orientamento da utilizzare quando l'applicazione web è eseguita attraverso un dispositivo mobile.
- **Any:** Nessun orientamento forzato.
- **Landscape:** Forza un layout orizzontale (più largo che alto).
- **Portrait:** Forza un layout verticale (più alto che largo).
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_threads/emscripten_pool_size:
.. rst-class:: classref-property
:ref:`int<class_int>` **threads/emscripten_pool_size** :ref:`🔗<class_EditorExportPlatformWeb_property_threads/emscripten_pool_size>`
Il numero di thread che emscripten allocherà all'avvio. Un valore inferiore allocherà meno thread e consumerà meno risorse di sistema, ma si corre il rischio di esaurire i thread nel pool e di dover allocare altri thread in fase di esecuzione, causando un deadlock.
\ **Nota:** Alcuni browser hanno un limite massimo al numero di thread che si possono allocare, quindi è meglio essere cauti e mantenere questo numero basso.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_threads/godot_pool_size:
.. rst-class:: classref-property
:ref:`int<class_int>` **threads/godot_pool_size** :ref:`🔗<class_EditorExportPlatformWeb_property_threads/godot_pool_size>`
Override for the default size of the :ref:`WorkerThreadPool<class_WorkerThreadPool>`. This setting is used when :ref:`ProjectSettings.threading/worker_pool/max_threads<class_ProjectSettings_property_threading/worker_pool/max_threads>` size is set to ``-1`` (which it is by default). This size must be smaller than :ref:`threads/emscripten_pool_size<class_EditorExportPlatformWeb_property_threads/emscripten_pool_size>` otherwise deadlocks may occur.
When using threads, this size needs to be large enough to accommodate features that rely on having a dedicated thread like :ref:`ProjectSettings.physics/2d/run_on_separate_thread<class_ProjectSettings_property_physics/2d/run_on_separate_thread>` or :ref:`ProjectSettings.rendering/driver/threads/thread_model<class_ProjectSettings_property_rendering/driver/threads/thread_model>`. In general, it is best to ensure that this is at least ``4`` and is at least ``2`` or ``3`` less than :ref:`threads/emscripten_pool_size<class_EditorExportPlatformWeb_property_threads/emscripten_pool_size>`.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_variant/extensions_support:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **variant/extensions_support** :ref:`🔗<class_EditorExportPlatformWeb_property_variant/extensions_support>`
Se ``true`` abilita il supporto di :ref:`GDExtension<class_GDExtension>` per questa build web.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_variant/thread_support:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **variant/thread_support** :ref:`🔗<class_EditorExportPlatformWeb_property_variant/thread_support>`
Se ``true``, il gioco esportato supporterà i thread. Richiede `un sito web "cross-origin isolated" <https://web.dev/articles/coop-coep>`__, che potrebbe essere difficile da configurare ed è limitato per motivi di sicurezza (ad esempio, non essendo in grado di comunicare con siti web di terze parti).
Se ``false``, il gioco esportato non supporterà i thread. Di conseguenza, è più soggetto a problemi di prestazioni e audio, ma richiederà solo di essere eseguito su un sito web HTTPS.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_vram_texture_compression/for_desktop:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **vram_texture_compression/for_desktop** :ref:`🔗<class_EditorExportPlatformWeb_property_vram_texture_compression/for_desktop>`
Se ``true``, consente di ottimizzare le texture per i desktop attraverso l'algoritmo S3TC/BPTC.
.. rst-class:: classref-item-separator
----
.. _class_EditorExportPlatformWeb_property_vram_texture_compression/for_mobile:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **vram_texture_compression/for_mobile** :ref:`🔗<class_EditorExportPlatformWeb_property_vram_texture_compression/for_mobile>`
Se ``true`` consente di ottimizzare le texture per i dispositivi mobili attraverso l'algoritmo ETC2/ASTC.
.. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)`
.. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)`
.. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)`
.. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)`
.. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)`
.. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)`
.. |void| replace:: :abbr:`void (Nessun valore restituito.)`