# Cosa aggiunge PlayDrop al tuo gioco

Cosa fa un gioco PlayDrop con SDK, catalogue.json e hosting, dove è disponibile ogni funzione e la guida: salvataggi, classifiche, gruppi, server, guadagni.

Source: https://www.playdrop.ai/it/create/learn/playdrop-games

Un gioco PlayDrop è un gioco web che PlayDrop ospita, mette in elenco ed esegue sul suo sito e nelle app PlayDrop per iOS, Android, Windows e macOS. Nelle app un gioco gira a schermo intero, senza la barra del browser intorno; è lo stesso gioco web eseguito nella vista di gioco dell’app, non una build nativa separata. Questa pagina elenca cosa può aggiungere PlayDrop e dove è documentata ogni parte.

## Due modi per entrare

| | HTML semplice | Pacchetto |
|---|---|---|
| Cosa invii | Un solo file HTML autonomo, fino a 10 MiB | Una cartella compilata, uno ZIP o un .play con catalogue.json |
| SDK di PlayDrop | No | Sì, tutte le funzioni qui sotto |
| Immagini e video della scheda | No | Sì |
| Server di gioco ospitato | No | Sì |
| Guida | [Giochi in HTML semplice](https://www.playdrop.ai/it/create/learn/html-games) | [Pacchetti](https://www.playdrop.ai/it/create/learn/packaging) |

Qualsiasi gioco può partire semplice e diventare un pacchetto in seguito, con lo stesso nome e lo stesso link.

## Cosa ottengono i giocatori

| Funzione | Cosa dà ai giocatori | Guida |
|---|---|---|
| Ciclo di vita dell’host | Pausa e ripresa pulite, audio che segue la scelta del giocatore di disattivarlo, un primo frame veloce | [Caricamento, pausa e audio](https://www.playdrop.ai/it/create/learn/lifecycle) |
| Layout a schermo intero | Gioco da bordo a bordo con l’HUD lontano da notch e comandi di PlayDrop | [Schermo intero e aree sicure](https://www.playdrop.ai/it/create/learn/viewport) |
| Salvataggi cloud | Progressi che seguono il giocatore da un dispositivo all’altro | [Salvataggi cloud](https://www.playdrop.ai/it/create/learn/cloud-saves) |
| Classifiche | Punteggi migliori e posizione del giocatore | [Classifiche](https://www.playdrop.ai/it/create/learn/leaderboards) |
| Obiettivi | Traguardi con icone e progressi | [Obiettivi](https://www.playdrop.ai/it/create/learn/achievements) |
| Condivisione e inviti | Finestre di condivisione con un’immagine o una clip, inviti agli amici e carte di gioco in chat | [Condivisione, amici e inviti](https://www.playdrop.ai/it/create/learn/social) |
| Gruppi online e voce | Gli amici entrano insieme nella stessa stanza, con voce della stanza facoltativa | [Gruppi online e voce](https://www.playdrop.ai/it/create/learn/online-party) |
| Gruppi locali e controller | Gamepad e telefoni come controller sullo stesso schermo | [Gruppi locali e controller](https://www.playdrop.ai/it/create/learn/local-party) |
| Server in tempo reale | Stanze Colyseus con un database MongoDB per gioco | [Server di gioco in tempo reale](https://www.playdrop.ai/it/create/learn/game-servers) |
| Recensioni, mance, acquisti e annunci | Modi per i giocatori di sostenere il gioco; crediti per il creator | [Monetizzazione](https://www.playdrop.ai/it/create/learn/monetization) |
| Asset e generazione con l’IA | Asset condivisi, contenuti generati e creazioni dei giocatori | [Asset di gioco](https://www.playdrop.ai/it/create/learn/game-assets), [Asset con l’IA](https://www.playdrop.ai/it/create/learn/ai-assets), [Formati personalizzati](https://www.playdrop.ai/it/create/learn/custom-assets) |

## Cosa ottiene la scheda

catalogue.json dà al gioco la sua pagina: titolo, descrizione, genere e [tag](https://www.playdrop.ai/it/create/learn/tags), [icona, immagini principali, screenshot e video](https://www.playdrop.ai/it/create/learn/listing-assets), [traduzioni](https://www.playdrop.ai/it/create/learn/localization) e idoneità a [Instant](https://www.playdrop.ai/it/create/learn/instant-games). La [visibilità](https://www.playdrop.ai/it/create/learn/distribution) decide chi può aprirlo: privato per i test, non in elenco per chiunque abbia il link, pubblico per farsi scoprire su PlayDrop, aperto ai motori di ricerca. La visibilità pubblica crea occasioni per farsi scoprire; non garantisce giocatori.

## Dove è disponibile ogni funzione

Il sito e le app eseguono lo stesso gioco con lo stesso SDK, ma alcune funzioni dell’host dipendono dal dispositivo:

- La vibrazione funziona solo nelle app native; `sdk.haptics.supported` te lo indica.
- La condivisione di una clip video dipende dall’host; gli host che non la supportano rifiutano la richiesta invece di condividere un semplice link.
- Il gioco offline e il precaricamento dei file avvengono nelle app native per i giochi che li dichiarano; il sito carica i giochi online.
- La voce della stanza e i gruppi dipendono dalla build dell’host, dall’accesso e dal rilascio graduale sulla piattaforma.
- Gli annunci dipendono dall’host e dagli spazi pubblicitari disponibili; `load()` segnala quando nessuno è pronto.

Progetta il gioco in modo che resti giocabile quando manca un servizio facoltativo.

## Inizia con l’SDK

Carica l’SDK, leggi lo stato dell’host, poi segnala che il gioco è pronto quando il primo frame previsto è sullo schermo:

```html
<script src="https://assets.playdrop.ai/sdk/playdrop.js"></script>
<script type="module">
  const sdk = await playdrop.init();
  // Set up pause, audio and HUD from sdk.host, then render the first frame.
  sdk.host.ready();
</script>
```

Continua con [caricamento, pausa e audio](https://www.playdrop.ai/it/create/learn/lifecycle). Il [riferimento dell’SDK client](https://www.playdrop.ai/it/create/learn/sdk) elenca ogni namespace.

## Cosa non può fare il connettore

La tua app di IA pubblica giochi compilati e legge il tuo account. Non può aprire né modificare i giochi creati in PlayDrop Studio, restituire codice sorgente o caricare codice eseguibile di modelli 3D. Questi limiti appartengono al connettore, non alla piattaforma: Studio e gli strumenti di PlayDrop possono comunque farlo.

## Guide correlate

- [Giochi in HTML semplice](https://www.playdrop.ai/it/create/learn/html-games): Pubblica un file HTML autonomo fino a 10 MiB con upload_game: cosa ci sta, il mini catalogo, la visibilità, gli aggiornamenti e quando passare a un pacchetto.
- [Pacchetti e .play](https://www.playdrop.ai/it/create/learn/packaging): Organizza una cartella compilata, uno ZIP o un .play con catalogue.json nella radice, dichiara scheda e server e caricalo con prepare_catalogue_upload.
- [Caricamento, pausa e audio](https://www.playdrop.ai/it/create/learn/lifecycle): Inizializza l’SDK, chiama ready al primo frame giocabile, gestisci pausa e ripresa, rispetta l’audio dell’host e precarica i file per app native e offline.
- [SDK client](https://www.playdrop.ai/it/create/learn/sdk): Riferimento dell’SDK browser di PlayDrop: host, identità, salvataggi, controller, social, multiplayer, negozio, annunci, classifiche, obiettivi, asset e IA.