Requisiti di integrazione

Questa sezione illustra l'integrazione tra Playable e l'SDK YouTube Playables.

Importante: i requisiti tradotti sono forniti solo a scopo di riferimento. Per indicazioni definitive, consulta le versioni in inglese dei requisiti.

1 Caricare l'SDK Playables

• Il gioco DEVE caricare l'SDK Sala giochi di YouTube prima di qualsiasi codice di gioco.

2 Notifica di gioco pronto

• Il gioco DEVE chiamare firstFrameReady quando esegue il rendering di una schermata di caricamento o iniziale che comunica esplicitamente all'utente che il processo di caricamento è in corso.
• Il gioco DEVE chiamare gameReady e DEVE chiamare gameReady solo quando il gioco è pronto per l'interazione dell'utente (ad esempio, il menu principale o il gioco è pronto per essere giocato).
• Il gioco NON DEVE chiamare gameReady mentre all'utente vengono ancora visualizzati elementi non interattivi (ad esempio, schermate iniziali o di caricamento schermate).

YouTube non rimuove l'indicatore di caricamento finché non viene chiamata questa API.

3 Punteggi utente

• Il gioco PUÒ utilizzare sendScore per inviare il punteggio dell'utente.
• Se il gioco utilizza sendScore per inviare i punteggi, DEVE rispettare la specifica sendScore e DEVE assicurarsi che il punteggio migliore inviato corrisponda al punteggio migliore nel salvataggio del gioco.

4 Salvataggi sul cloud

• Il gioco DEVE chiamare saveData per salvare i progressi quando gli utenti hanno fatto progressi di gioco significativi (ad esempio, un cambio di livello) in cui le meccaniche di gioco portano l'utente a credere che i suoi progressi siano stati salvati.
• Il gioco NON DEVE utilizzare altri meccanismi per salvare i progressi dell'utente. Questa funzionalità consente ai giocatori di riprendere il gioco in un secondo momento.
• Il gioco DEVE attendere loadData prima di chiamare saveData. Se saveData viene chiamato prima del completamento di loadData, la richiesta verrà rifiutata. In questo modo, il gioco non sovrascrive i dati salvati in precedenza.
• Il gioco DEVE essere in grado di utilizzare i dati di salvataggio sul cloud delle versioni precedenti del gioco senza errori o arresti anomali.
• Il gioco DOVREBBE utilizzare i dati di salvataggio sul cloud per mantenere i progressi dell'utente in tutte le versioni del gioco in cui l'utente si aspetta che i suoi dati vengano utilizzati.
• I giochi DOVREBBERO salvare automaticamente i progressi dell'utente in corrispondenza di importanti traguardi di gioco per evitare la perdita di dati. Un salvataggio finale viene eseguito quando un utente esce dal gioco, ma è il migliore sforzo e può salvare solo fino a 64 KiB di lunghezza dei contenuti.

5 Pulsante di attivazione/disattivazione audio

• Il gioco DEVE rispettare l'impostazione audio del sistema e il pulsante di disattivazione audio.
• Il gioco DEVE rispettare l'impostazione audio e il pulsante di disattivazione audio di YouTube utilizzando isAudioEnabled e onAudioEnabledChange.
• Il gioco DEVE rispettare il controllo del volume sul dispositivo.
• L'audio del gioco NON DEVE essere riprodotto in modo imprevisto.
• Quando la disattivazione audio di YouTube è impostata, l'audio NON DEVE essere riprodotto e i controlli audio del gioco NON DEVONO influire sull'uscita audio.
• Quando la disattivazione audio di YouTube non è impostata, i controlli audio del gioco POSSONO influire sull'output audio.
• Il gioco NON DOVREBBE mostrare un pulsante di disattivazione audio generale all'interno del gioco stesso; consenti agli utenti di fare affidamento sulle funzionalità a livello di YouTube per questo.
• Il gioco PUÒ avere controlli audio granulari separati nel gioco, ad esempio per musica ed effetti sonori, ma DEVE rispettare tutti gli altri requisiti di controllo audio.

6 Mettere in pausa e riprendere

L'SDK Playables fornisce callback per le funzionalità di pausa e ripresa multipiattaforma.

• Il gioco DEVE mettere in pausa tutta l'esecuzione dopo la chiamata di onPause e DEVE riprendere l'esecuzione solo quando viene chiamata onResume. L'esecuzione include tutte le funzionalità di Playable, come il ciclo di gioco, la musica, le interazioni, le chiamate di rete e il rendering.
• Il gioco NON DEVE utilizzare l'API web Page Visibility o API web simili e DEVE utilizzare solo onPause e onResume dell'SDK Playables.
• Il gioco DOVREBBE salvare i progressi dell'utente quando si verifica onPause.