:github_url: hide .. _class_EditorExportPlatformWeb: EditorExportPlatformWeb ======================= **Eredita:** :ref:`EditorExportPlatform` **<** :ref:`RefCounted` **<** :ref:`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 ````. Normalmente, il canvas non può essere posizionato o ridimensionato manualmente, ma altrimenti funge da :ref:`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` | :ref:`custom_template/debug` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`custom_template/release` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`html/canvas_resize_policy` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`html/custom_html_shell` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`html/experimental_virtual_keyboard` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`html/export_icon` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`html/focus_canvas_on_start` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`html/head_include` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`progressive_web_app/background_color` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`progressive_web_app/display` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`progressive_web_app/enabled` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`progressive_web_app/ensure_cross_origin_isolation_headers` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`progressive_web_app/icon_144x144` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`progressive_web_app/icon_180x180` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`progressive_web_app/icon_512x512` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`progressive_web_app/offline_page` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`progressive_web_app/orientation` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`threads/emscripten_pool_size` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`threads/godot_pool_size` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`variant/extensions_support` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`variant/thread_support` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`vram_texture_compression/for_desktop` | +-----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`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` **custom_template/debug** :ref:`🔗` 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` **custom_template/release** :ref:`🔗` 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` **html/canvas_resize_policy** :ref:`🔗` 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`. - **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` **html/custom_html_shell** :ref:`🔗` 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` **html/experimental_virtual_keyboard** :ref:`🔗` **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` **html/export_icon** :ref:`🔗` 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` **html/focus_canvas_on_start** :ref:`🔗` 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` **html/head_include** :ref:`🔗` I tag HTML aggiuntivi da includere all'interno di ````, come i tag ````. \ **Nota:** non è necessario aggiungere un tag ````, 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.)`