Documentazione di Steamworks
Verifica della compatibilità su Steam Deck e Steam Machine
Anche se il tuo titolo può funzionare alla grande su Steam Deck e Steam Machine senza alcun lavoro da parte tua, è possibile che il diverso sistema operativo e i diversi fattori di forma possano influire sull'esperienza.

A tal fine, abbiamo progettato un sistema per mostrare a colpo d'occhio il modo in cui i giochi si comporteranno su Steam Deck e Steam Machine, offrendo agli sviluppatori criteri specifici da prendere in considerazione e aiutando i clienti a trovare esperienze fluide e confortevoli.

Il cuore del sistema è un processo di verifica della compatibilità che ha una struttura simile al processo di verifica delle build di Steam:

  1. Valve esaminerà il tuo gioco su Steam Deck e Steam Machine, verificandolo in base a una serie specifica di criteri. (Vedi la lista di controllo per la compatibilità sottostante.)
  2. Al termine della revisione, ti verranno forniti risultati dettagliati attraverso il sito per i partner di Steamworks.
  3. Vedrai un'anteprima di come questi risultati sono tradotti in valutazioni di compatibilità visibili ai clienti: una valutazione per Steam Deck, una per Steam Machine e una per tutti gli altri dispositivi compatibili con SteamOS.
  4. Avrai una settimana per esaminare questi risultati prima che vengano pubblicati.
  5. Una volta pubblicati, i clienti potranno visualizzare i risultati dei test di compatibilità nel Negozio di Steam e nelle loro Librerie.
  6. I risultati della verifica della compatibilità non influiscono sulla disponibilità del tuo gioco ai clienti su Steam Deck o Steam Machine, ma influenzeranno il modo in cui il tuo titolo viene presentato.

C'è una sovrapposizione significativa tra i criteri di test per Steam Deck e Steam Machine, come i test per il supporto dei controller, l'input di testo, i launcher, ecc. Questo presenta due vantaggi:
  1. Come sviluppatore di videogiochi, hai un unico gruppo comune di criteri di compatibilità a cui puntare.
  2. Qualsiasi gioco che sia Verificato su Steam Deck è garantito per essere Verificato anche su Steam Machine.

https://youtu.be/a8tNvhwkth8

Valutazioni di compatibilità

Molti giochi funzionano benissimo così come sono su Steam Deck e Steam Machine. Tuttavia, alcuni giochi potrebbero richiedere una configurazione manuale dell'utente, oppure essere rilevanti solo per utenti con configurazioni specifiche. Altri giochi potrebbero non offrire una buona esperienza a causa del passaggio a un fattore di forma portatile o di un'incompatibilità con lo stack software/hardware di Steam.
Nota: le valutazioni di Steam Deck e Steam Machine sono indipendenti per ogni titolo.

L'obiettivo principale del processo di verifica della compatibilità è consentire ai clienti di capire a colpo d'occhio a quali di questi gruppi appartiene ciascun gioco assegnandogli una certificazione:

Simbolo VerificatoIl tuo gioco ha superato tutti i controlli di compatibilità. L'utente non deve eseguire alcuna configurazione per accedere a tutte le funzionalità del gioco.
Simbolo GiocabileIl tuo gioco funziona su Steam Deck/Steam Machine, ma potrebbe richiedere una configurazione manuale da parte dell'utente (esempi: selezionare manualmente una configurazione del controller della Comunità, richiedere all'utente di richiamare manualmente la tastiera su schermo, oppure di usare il touchscreen (sul Deck) per spostarsi all'interno di un launcher).
Simbolo Non supportatoIl tuo gioco non funziona su questo dispositivo a causa di un'incompatibilità con Proton o con componenti hardware specifici.
Simbolo SconosciutoQuesto gioco non ha completato il processo di verifica della compatibilità. Le informazioni sul modo in cui il gioco sarà giocabile su questo dispositivo non sono disponibili.

Una volta pubblicati i risultati, gli utenti vedranno la certificazione di compatibilità corrispondente quando sfogliano i giochi sia nel Negozio che nella Libreria. Queste certificazioni sono progettate per aiutare gli utenti a identificare rapidamente le esperienze adatte ai loro obiettivi e configurazione mentre sfogliano i giochi.

Lista di controllo della compatibilità


Per poter ricevere la certificazione Deck Verified e il relativo simbolo Verificato, dovrai soddisfare tutti i criteri seguenti, mirati ad aiutare i clienti a sentirsi a proprio agio quando giocano al tuo titolo su questi dispositivi. La maggior parte dei mancati superamenti di questa categoria farà sì che il tuo gioco appaia con la certificazione Giocabile e il relativo simbolo Giocabile.

Requisiti per Steam Deck e Steam Machine


Input
  • Supporto dei controller:
    • Su Steam Deck, il tuo gioco deve supportare i controlli fisici di Steam Deck. Su Steam Machine, il tuo gioco deve supportare gli input dello Steam Controller (fondamentalmente gli stessi input di Steam Deck).
    • La configurazione predefinita del controller deve permettere agli utenti di accedere a tutti i contenuti.
    • I giocatori non devono dover regolare alcuna impostazione in gioco per poter abilitare il supporto del controller o questa configurazione.
  • Glifi del controller: i glifi sullo schermo devono corrispondere agli input utilizzati, che siano glifi di Steam Deck, di Steam Controller o Xbox. I glifi del mouse e della tastiera non devono essere mostrati se non rappresentano l'input attivo. L'interazione con qualsiasi input di Steam Deck o Steam Controller utilizzando la configurazione predefinita non deve mostrare glifi non appartenenti al controller. (Raccomandazioni: consigliamo caldamente di utilizzare l'API SteamInput, che mostrerà automaticamente i glifi corretti, indipendentemente dal dispositivo di input utilizzato dall'utente.)
  • Input di testo: se il tuo gioco richiede di inserire del testo (ad esempio, per dare un nome a un personaggio o a un file salvato), devi usare un'API di Steamworks per l'immissione di testo per aprire la tastiera su schermo per i giocatori che usano un controller, oppure avere una voce integrata che consente agli utenti di inserire il testo nella loro lingua usando solo un controller.

Prestazioni
  • Configurazione predefinita: il gioco deve essere rilasciato con una configurazione predefinita che risulti in un framerate giocabile. Su Steam Deck, la configurazione predefinita è 30 FPS a 800p, e su Steam Machine è 30 FPS a 1080p.

Funzionalità
  • Nessun avviso di compatibilità del dispositivo: l'applicazione non deve presentare all'utente informazioni che indicano che il software di Steam Deck/Steam Machine (ovvero, la distribuzione Linux specifica) o l'hardware (ovvero, la GPU) non sia supportato.
  • Launcher: per i giochi con launcher, anche questi ultimi devono soddisfare i requisiti qui elencati, compresa la navigabilità completa con un controller. (Raccomandazioni: consigliamo caldamente di non richiedere all'utente di navigare in un lancher per giocare al tuo titolo.)

Requisiti Proton
  • Proton è un layer di compatibilità di Windows. Su Steam Deck e Steam Machine, i giochi senza build native di Linux saranno eseguiti tramite Proton, una serie di strumenti che prenderanno automaticamente il tuo eseguibile attuale di Windows e i dati di gioco e li eseguiranno sul sistema operativo basato su Linux di Steam Deck e Steam Machine.
  • Proton è ancora in via di sviluppo ed è possibile che il tuo gioco non sia ancora pienamente supportato. Se la verifica della compatibilità del tuo gioco rivela bug che bloccano il titolo o problemi di prestazioni specifici di Proton, questi problemi saranno aggiunti al nostro sistema interno di tracciamento e il tuo gioco apparirà con una certificazione Non supportato e il relativo simbolo Non supportato. Una volta che i problemi saranno stati risolti, ti avviseremo automaticamente e testeremo nuovamente il tuo gioco.

Requisiti specifici per Steam Deck

Nota: i test di visualizzazione non vengono eseguiti su Steam Machine perché la risoluzione e le dimensioni del testo possono variare a seconda delle dimensioni e del tipo di display utilizzato.

Schermo
  • Supporto della risoluzione: il gioco deve poter funzionare a una risoluzione supportata da Steam Deck (raccomandazioni: quando possibile, consigliamo di supportare le risoluzioni native del Deck di 1280x800 (consigliata) o di 1280x720.)
  • Leggibilità del testo: il testo dell'interfaccia deve essere facilmente leggibile a una distanza di 30 cm dallo schermo. In altre parole, il carattere più piccolo su schermo non deve mai avere un'altezza inferiore a 9 pixel alla risoluzione di 1280x800 (raccomandazioni: prevediamo che Steam Deck verrà utilizzato in un'ampia gamma di configurazioni di illuminazione e fisiche, ad esempio connesso a una TV, a un monitor o a una tastiera. Consigliamo di supportare una dimensione del testo e, quando possibile, un contrasto configurabili dall'utente. Benché 9 pixel sia la dimensione del testo minima assoluta per l'approvazione, consigliamo di utilizzare 12 pixel quando possibile.)

Libreria e Negozio di Steam

Libreria

La Libreria dell'utente su Steam Deck e Steam Machine è un'estensione della sua Libreria sul desktop e viceversa. Tutti i giochi di proprietà di un cliente appaiono automaticamente nella sua Libreria sul dispositivo al primo accesso. I giochi acquistati su qualsiasi dispositivo appariranno nella sua Libreria sugli altri dispositivi.

Come per le altre piattaforme, i clienti possono filtrare e ordinare la loro Libreria per nome, stato d'installazione, ecc. Oltre a queste opzioni comuni, su Steam Deck gli utenti possono ordinare e filtrare per compatibilità con il Deck, così come gli utenti di Steam Machine possono farlo per compatibilità con la Steam Machine.

Negozio di Steam su Steam Deck e su Steam Machine


Il Negozio di Steam è facilmente accessibile su Steam Deck e Steam Machine e comprende tutte la funzionalità del Negozio di Steam e i prodotti disponibili nella regione del cliente. Ai clienti che sfogliano il Negozio di Steam su questi dispositivi non viene impedito di visualizzare o acquistare contenuti che potrebbero non funzionare bene sul loro dispositivo (esempi: titoli VR su Deck, giochi basati sulla tastiera). In questi casi, le pagine del Negozio forniscono dettagli basati sulla verifica della compatibilità che spiegano ai clienti cosa possono aspettarsi se cercano di eseguire questi prodotti su un Deck o Steam Machine.

Didascalia dell'immagine (sinistra): i dettagli del gioco per un'applicazione hanno una sezione per la "Compatibiiltà con Steam Deck" che mostra il gruppo di compatibilità. Su una Steam Machine, questa sezione mostrerebbe la compatibilità con Steam Machine.
Didascalia dell'immagine (destra): gli utenti possono esaminare la valutazione di compatibilità di qualsiasi applicazione per un'analisi dettagliata dell'esperienza che possono aspettarsi. Queste informazioni vengono presentate ai clienti in base ai risultati dei test di Valve.

Processo di verifica della compatibilità


Ci sono tre modi diversi per aggiungere un gioco alla coda di test:

  • Quando un titolo in catalogo soddisfa una determinata euristica automatizzata, verrà aggiunto automaticamente alla coda di verifica senza che tu debba inviare una richiesta manuale.
  • Quando Valve ritiene che un gioco sia importante per i clienti con hardware di Steam, a volte potremmo aggiungere giochi alla coda di verifica senza bisogno di inviare una richiesta manuale.
  • I partner possono richiedere manualmente una verifica per un titolo in arrivo o in catalogo utilizzando il link "Verifica della compatibilità con l'hardware di Steam" nelle sezioni Strumenti tecnici della pagina principale della tua applicazione. (Nota: questo link non è disponibile per tutti i partner. Stiamo gradualmente aumentando il numero di partner che possono accedervi.)

Al termine della verifica della compatibilità del tuo gioco, riceverai un'e-mail automatica, simile alle notifiche di revisione della pagina del Negozio e della build. Allo stesso tempo, sul sito per i partner di Steamworks saranno consultabili informazioni dettagliate punto per punto. Ci sono tre configurazioni hardware che testiamo (Steam Deck, Steam Machine e dispositivi di gioco di terze parti con SteamOS) e potrai vedere il resoconto dettagliato dei test e la valutazione di compatibilità visibile ai clienti per ciascun dispositivo.

A questo punto, avrai alcune opzioni:

  • Puoi scegliere di pubblicare i risultati del processo di verifica della compatibilità. La pubblicazione di questi risultati è separata e non interferisce in alcun modo con le impostazioni di Steamworks o la pubblicazione della tua pagina del Negozio.
  • Se desideri apportare delle modifiche in risposta ai risultati del test (ad esempio aggiungere una configurazione predefinita per il controller o integrare la chiamata a un'API per tastiere), puoi pubblicare una nuova build e richiedere un'altra verifica.
  • Se ritieni che ci siano degli errori nei risultati del test, puoi rispondere direttamente dal sito dei partner per richiedere o presentare ulteriori informazioni.

Se non intraprendi alcuna azione, dopo circa una settimana i risultati della verifica verranno automaticamente pubblicati e mostrati nella pagina di dettaglio del tuo gioco come risultati dei test di Valve (vedi la sezione "Negozio di Steam su Steam Deck e su Steam Machine" sopra).


Didascalia dell'immagine: la pagina di dettaglio dell'applicazione e l'overlay dei risultati di compatibilità, prima e dopo la pubblicazione dei risultati del test di compatibilità.

Aggiunta di un post su un evento di Steam

Potresti voler fornire ai clienti delle informazioni aggiuntive sulla compatibilità con l'hardware di Steam del tuo gioco, o condividere i tuoi programmi futuri. Un modo per condividere tali informazioni è pubblicare un evento di Steam sulla compatibilità del tuo gioco e includere quel link nella visualizzazione dei dettagli di compatibilità con l'hardware di Steam.

Ecco come fare:
  • Crea un nuovo annuncio di Steam dal tuo Hub della Comunità del tuo gioco, condividendo le informazioni e i dettagli che desideri riguardo alla compatibilità.
  • Pubblica il post, quindi copia l'URL.
  • Incolla l'URL dell'evento nel campo "Informazioni sulla compatibilità con l'hardware di Steam". Si trova nella scheda Informazioni di base degli strumenti Modifica pagina del Negozio del tuo prodotto.

La schermata dei dettagli sulla compatibilità del tuo gioco con Steam Deck/Steam Machine e con la versione desktop di Steam indirizzerà gli utenti a visualizzare il post.

deck_compat_developer_post_desktop_1.png

Domande frequenti


Quali tipologie di applicazioni possono richiedere una verifica della compatibilità?
Attualmente, questo processo è disponibile soltanto per i giochi. Non sono disponibili processi di verifica della compatibilità per gli altri tipi di applicazione, ad esempio demo, DLC, strumenti o colonne sonore, se non per casi eccezionali.

Quanto tempo occorre per completare una verifica della compatibilità una volta che il mio gioco è in coda?
Puntiamo a completare le verifiche della compatibilità e fornire i risultati ai partner entro una settimana dalla richiesta. Ci aspettiamo che la tempistica delle verifiche potrà variare in base alla portata e alla complessità degli altri titoli in coda.

Il processo di verifica della compatibilità o i risultati del test avranno qualche effetto sulla normale procedura di rilascio su Steam?
No, il processo di verifica della compatibilità è completamente separato dalla procedura di revisione per il rilascio su Steam. I risultati della tua verifica di compatibilità non andranno a influenzare il tuo rilascio globale su Steam in alcun modo, né durante le sue fasi (non ancora in fase di verifica, in fase di verifica attiva, verifica completata) né una volta determina la sua categorizzazione.

Posso richiedere una verifica della compatibilità prima del rilascio iniziale del mio gioco?
Sì, è possibile richiedere una verifica della compatibilità per i titoli non rilasciati.

Non trovo alcun modo per inviare manualmente i miei titoli già rilasciati per la revisione. Come faccio a richiedere la revisione per i giochi che ho già pubblicato?
Stiamo esaminando il catalogo dei giochi pubblicati, dando priorità a quelli più giocati dai possessori di hardware di Steam. Quando arriveremo al tuo gioco, lo revisioneremo automaticamente e ti informeremo dei risultati. Consulta il Processo di verifica della compatibilità qui sopra per ulteriori dettagli.

Prima di richiedere la verifica della compatibilità, devo completare il normale processo di revisione per il rilascio/per la build?
Sì, prima di effettuare una richiesta di verifica della compatibilità, chiediamo che il tuo gioco abbia già completato con successo la revisione standard della build.

Se aggiorno il mio gioco dopo la pubblicazione dei primi risultati di compatibilità, posso richiedere che il mio gioco venga nuovamente sottoposto a revisione?
Sì, puoi inviare un ticket all'Assistenza chiedendo che il tuo gioco venga nuovamente sottoposto a revisione e che venga inviato un rapporto aggiornato. Non appena giungono nuove informazioni, che sia una nuova build o rapporti del controllo qualità interno o dati degli utenti, saremo lieti di ripetere i test per assicurarci che i clienti continuino ad avere i dati più accurati e aggiornati sul tuo gioco.

Posso richiedere che la verifica della compatibilità venga effettuata su un ramo specifico?
Sì, quando invii la richiesta di verifica della compatibilità per il tuo gioco, potrai selezionare quale ramo desideri venga verificato. Se non specifichi alcun ramo, testeremo quello predefinito.

Sono stati introdotti dei nuovi requisiti relativi alle risorse del Negozio o della Libreria specifiche per Steam Deck/Steam Machine?
No, non vi è alcun nuovo requisito per Steam Deck/Steam Machine.

Ritengo che il mio gioco non sia adatto per Steam Deck/Steam Machine. Posso impedire che venga mostrato nel Negozio e nella Libreria su Steam Deck o Steam Machine?
La rimozione dei prodotti disponibili su Steam dal Negozio o dalla Libreria di Steam Deck/Steam Machine non rientra nelle funzionalità supportate. Questi dispositivi sono un'estensione di Steam, quindi i clienti si aspettano e hanno accesso allo stesso Negozio e alla stessa Libreria che avrebbero su qualsiasi altro PC.

Potete aspettare a pubblicare i risultati del mio test di compatibilità fino a quando risolviamo alcuni dei problemi che avete rilevato, finché non completiamo un passaggio di ottimizzazione o finché il nostro controllo qualità interno non completa i propri test?
Se ricevi i risultati del tuo test di compatibilità e invii una nuova build del gioco che risolve tali problemi prima della pubblicazione dei risultati, ritarderemo la pubblicazione e ripeteremo i test sulla nuova build. Non ritarderemo la pubblicazione dei risultati del test di compatibilità per i lavori successivi.

Il programma di verifica della compatibilità con è un servizio che mira ad aiutare gli utenti a comprendere il tipo di esperienza che ci si può aspettare da un gioco prima di presentarlo su Steam Deck o Steam Machine. A questo scopo, riteniamo che sia essenziale che gli utenti possano vedere il più rapidamente possibile i dati che riportano lo stato attuale di qualsiasi gioco.

Non appena giungono nuove informazioni, che sia una nuova build o rapporti del controllo qualità interno o dati degli utenti, saremo lieti di ripetere i test per assicurarci che i clienti continuino ad avere i dati più accurati e aggiornati sul tuo gioco.

Se ritieni che i risultati del test di cui vedi l'anteprima contengano dati errati per la build corrente, contattaci usando gli strumenti disponibili sul sito di Steamworks. Come citato in precedenza, il nostro obiettivo principale in questo caso è assicurarci che i dati visualizzati dai clienti siano accurati e utili.

Cosa significa quando un test di compatibilità afferma che uno dei miei giochi non è al momento supportato su Steam Deck o Steam Machine?
Quasi sempre, una valutazione Non supportato è provocata da uno dei due problemi seguenti:
  • Il tuo gioco usa un middleware o una tecnologia attualmente non supportata da Steam Deck/Steam Machine. Alcuni fornitori di software anti-cheat non sono al momento supportati, ad esempio, così come alcuni codec multimediali usati per il video o l'audio. Benché stiamo migliorando costantemente la gamma di software supportati da questi dispositivi, se il supporto per il middleware necessario per il funzionamento di parte o di tutto il tuo gioco non è ancora disponibile, il tuo gioco sarà considerato Non supportato.
  • Il tuo gioco si affida a una parte della funzionalità di Windows che non è ancora completamente implementata in Proton. Proton è un progetto in via di sviluppo, che continua a migliorare nel tempo. Quando incontriamo problemi in gioco durante i test, ne prendiamo nota e ripetiamo i test sul tuo gioco non appena siamo in grado di aggiungere la funzionalità necessaria a Proton.

Il tuo rapporto di compatibilità include un elenco completo dei test eseguiti su ciascun gioco. Tutti i problemi con Proton o con il middleware saranno evidenziati, così come i test specifici non superati e, nella maggior parte dei casi, un numero di tracciamento per il bug in questione.

Al termine della mia verifica di compatibilità, chi riceve la notifica e-mail?
Inviamo la notifica e-mail a tutti gli utenti che hanno inviato build o una richiesta di verifica della compatibilità del gioco che hanno ancora accesso tramite il tuo account da partner. Inviamo l'e-mail anche a tutti gli account per le comunicazioni associati al tuo gruppo di partner. Se non dovessimo trovare account per le comunicazioni, invieremo un'e-mail all'autorità effettiva del tuo partner.

In altre parole, puoi abilitare le notifiche e-mail di compatibilità per qualunque utente nella tua organizzazione assicurandoti che abbia attivato l'opzione "Ricevi le comunicazioni" per il proprio account. Per informazioni aggiuntive sulle autorizzazioni degli utenti, consulta la documentazione sulla Concessione delle autorizzazioni.

Non ho richiesto una nuova revisione del mio titolo già revisionato, ma ho ricevuto una notifica che mi informava che era comunque stata completata una nuova revisione. Come mai?
Valve eseguirà automaticamente una nuova revisione di titoli in svariate circostanze. Per esempio:
  • Abbiamo rilasciato, o ci stiamo preparando a rilasciare una nuova versione di Proton. Le nuove versioni di Proton sono dotate di nuove funzionalità e correzioni di bug e vogliamo aggiornare il rapporto e i risultati di compatibilità per riflettere la nuova versione (in caso di problemi per cui una nuova versione di Proton introduca un problema per il tuo titolo, questo continuerà a essere eseguito con la miglior versione stabile possibile di Proton finché il problema non sarà risolto).
  • Abbiamo aggiunto nuovi test al processo di verifica della compatibilità e per le ulteriori revisioni, così da assicurarci che i titoli abbiano dati e informazioni complete (ad esempio, abbiamo aggiunto di recente un test per determinare come i titoli interagiscono con i software esterni di limitazione degli FPS. Questo test non influenza la categoria di compatibilità del tuo titolo, ma è utile così da poter fornire una guida migliore per gli utenti con giochi che usano sistemi di limitazione interna degli FPS, come i giochi di lotta).
  • Abbiamo ricevuto segnalazioni dagli utenti o dagli sviluppatori a indicare che i dati dei nostri test erano imprecisi o incompleti.

Questi rapporti di ulteriori test automatici contengono le stesse identiche informazioni e non differiscono dai rapporti avviati dai partner: riceverai una notifica automatica via e-mail quando saranno resi pubblici e potrai scegliere se pubblicarli, effettuare delle modifiche o lasciare che i risultati vengano pubblicati automaticamente.

Se il mio gioco ha una versione di Linux nativa e viene selezionato per la verifica dall'euristica, la verifica della compatibilità verrà eseguita sulla build di Linux o sotto Proton?
Per impostazione predefinita testeremo la build di Linux se è disponibile. Se la build di Linux non supera i test di compatibilità o comunque presenta problemi significativi, testeremo la build di Windows del tuo gioco eseguita sotto Proton. Il nostro obiettivo è assicurare ai clienti l'esperienza più fluida e piacevole possibile su questi dispositivi, quindi useremo il risultato più favorevole dei test.

I risultati del tuo test di compatibilità indicheranno su quale runtime sono stati generati. Puoi vedere i dettagli nella sezione "Dettagli" del rapporto, nel campo "Runtime raccomandato".

Se ritieni che abbiamo testato la versione errata del tuo prodotto, puoi sempre richiedere una nuova verifica e specificare su quale piattaforma vorresti fare eseguire i test.

Ci sono altri suggerimenti non obbligatori affinché il mio gioco possa funzionare al meglio su Steam Deck o Steam Machine?
Nonostante tutti i punti elencati nella sezione Lista di controllo della compatibilità su questa pagina siano necessari per ricevere la certificazione Verified e il relativo simbolo di
verifica, sono disponibili ulteriori consigli tecnici che non hanno effetto sulla certificazione di compatibilità. Questi consigli sono pensati per aiutare i clienti a sentirsi a proprio agio, migliorare la durata della batteria, le prestazioni, ecc. e sono consultabili nella nostra documentazione relativa ai consigli.