Pubblicato un nuovo aggiornamento per RetroPass, il frontend per RetroArch e RetriX Gold in esecuzione su console Xbox One e Xbox Series X/S si rende compatibile anche con l’emulatore Xenia for UWP.

RetroPass non può essere configurato direttamente dalla console Xbox, questo perché non ha uno scraper integrato e inpostare tutta la configurazione direttamente su Xbox sarebbe abbastanza difficile.

Tuttavia RetroPass è reso compatibile con:

1. LaunchBox.
2. EmulationStation.

Limitazioni

• Solo Xbox.
• Ottimizzato solo per gamepad.
• Nessun tema personalizzato.
• Contenuto zippato supportato solo se i core RetroArch o RetriX Gold lo supportano.
• Nessun Scraper.

Prerequisiti

• Account sviluppatore Xbox e console configurati per la modalità sviluppatore.
• Se si utilizza RetroArch – versione v1.10.1. o superiore.
• Se si utilizza RetriX Gold – versione 3.0.19. o superiore.
• Per un’esperienza senza interruzioni, si consiglia di impostare un tasto di scelta rapida per uscire da RetroArch. Quando il contenuto viene avviato da RetroPass, una volta che l’utente esce da RetroArch con il tasto di scelta rapida o tramite il menu, tornerà immediatamente a RetroPass.
• Archiviazione esterna di qualsiasi tipo utilizzata per l’impostazione della libreria dei contenuti.
• Computer aggiuntivo per l’impostazione della libreria dei contenuti.

Installazione

1. Scaricare gli ultimi binari di RetroPass.
2. Connettersi a Xbox tramite Xbox Device Portal e installare:
   • RetroPass_x.yz0_x64.msix
   • 3 dipendenze appx nella cartella /Dependencies/x64/.

Configurazione con Launchbox

LaunchBox è l’opzione preferita, perché offre i migliori risultati se configurato correttamente. Principalmente:

• Supporto per più titoli e schermate di gioco.
• Imposta un core specifico per un gioco, se necessario.

1. Installare LaunchBox direttamente nella memoria esterna.
2. Installare e configurare LaunchBox per lavorare con RetroArch o RetriX Gold.
3. IMPORTANTE!!! Quando importi i tuoi contenuti, ti verrà chiesto di selezionare il tipo di media da scaricare. Se stai usando LaunchBox solo per configurare RetroPass, non è necessario scaricare tutti i tipi di media perché RetroPass necessita solo di un sottoinsieme. Accelererà il processo di configurazione e appesantirà meno il database di LaunchBox. Devi solo controllare questi tipi di media:
   • “Box – Front”.
   • “Screenshot – Game Title”.
   • “Screenshot – Gameplay”.
   • “Screenshot – Game Select”.
   • “Video”.

4. Assicurarsi che la proprietà <CommandLine> per ogni emulatore sia configurata correttamente in LaunchBox/Data/Emulators.xml. Il percorso non è importante, purché il nome principale sia specificato correttamente. RetroPass ignora la parte del percorso e ottiene solo il nome del core. Sa come passarlo correttamente a RetroArch o RetriX Gold.

<CommandLine>-L "cores\<core_name>.dll"</CommandLine>

Dove <core_name> è il nome del core che si desidera utilizzare per un particolare emulatore.

5. Facoltativamente, se devi configurare un core diverso per un gioco, andare su Launchbox, aprire “Modifica metadati/media” e modificare la riga di comando in Emulazione.

6. Scaricare il file di configurazione di Retropass e copiarlo nella root della memoria esterna.
7. Modificare il file di configurazione RetroPass.xml.

<relativePath> punta alla directory LaunchBox nella memoria esterna. Non inserire un percorso assoluto come “E:\LaunchBox”, perché quando la memoria esterna viene collegata alla Xbox, potrebbe essere riconosciuta con una lettera diversa. Ad esempio, se la cartella LaunchBox si trova nella radice della memoria esterna, dovrebbe essere configurata in questo modo:

<?xml version="1.0"?>
<dataSource>
	<type>LaunchBox</type>
	<relativePath>./LaunchBox</relativePath>
</dataSource>

8. A questo punto la configurazione è terminata. Collegare la memoria esterna a Xbox e avviare RetroPass. Seguire la sezione Prima esecuzione e Impostazioni.

Installazione con Emulation Station

Se non si desidera utilizzare LaunchBox, è anche possibile creare un’origine di metadati compatibile con Emulation Station.

1. Installare e configurare Emulation Station in modo che funzioni con RetroArch su PC, preferibilmente direttamente su una memoria esterna.
2. Scaricare tutte le immagini, descrizioni e video. Esistono vari scraper che possono scaricare risorse da vari database e inviarli ai file gamelist.xml di Emulation Station.
3. Modificare il file di configurazione RetroPass.xml.

<relativePath> punta alla directory Emulation Station sulla memoria esterna. Non inserire un percorso assoluto come “E:\EmulationStation”, perché quando la memoria esterna viene collegata alla Xbox, potrebbe essere riconosciuta con una lettera diversa. Ad esempio, se la cartella EmulationStation si trova nella radice della memoria esterna, dovrebbe essere configurata in questo modo:

<?xml version="1.0"?>
<dataSource>
	<type>EmulationStation</type>
	<relativePath>./EmulationStation</relativePath>
</dataSource>

4. Verificare che il file es_systems.cfg esista da qualche parte nella directory di Emulation Station e che abbia sistemi validi definiti, cioè:
   • Ignora la proprietà <path>, non deve essere impostata correttamente.
   • Assicurarsi che la proprietà <command> per ciascun sistema sia configurata correttamente. I percorsi non sono importanti, purché il nome principale sia specificato correttamente. RetroPass ignora tutto nella riga di comando tranne il nome principale. Sa come passarlo correttamente a RetroArch.
   • <fullname> è ciò che viene effettivamente visualizzato in RetroPass come nome del sistema.
   • Nell’esempio seguente, vengono mostrate solo le proprietà pertinenti:

<system>
	<name>nes</name>
	<fullname>Nintendo Entertainment System</fullname>	
	<command>-L %HOME%\\systems\nestopia_libretro.dll</command>
	<platform>nes</platform>
</system>

5. Impostare il file gamelist.xml per ogni sistema:
   • gamelist.xml deve trovarsi nella propria directory che equivale a <name> del sistema definito in es_systems.cfg. Ad esempio, in base all’esempio nel passaggio 3, si prevede che per NES dovrebbe essere /nes/gamelist.xml.
   • Tutti i percorsi definiti in <path>, <thumbnail>, <image>, <video> devono essere un percorso relativo a <relativePath> definito nel passaggio 3. Ad esempio, se in Retropass.xml percorso relativo è: <relativePath>./EmulationStation</relativePath>
   • E

	<game>
		<path>./contents/nes/Elite.nes</path>
		<name>Elite</name>
		<desc>The player...</desc>
		<thumbnail>./downloaded_images/nes/covers/Elite-thumb.jpg</thumbnail>
		<image>./downloaded_images/nes/Elite-image.jpg</image>
		<video>./videos/nes/Elite.mp4</video>
		<releasedate>19910101T000000</releasedate>
		<developer>David Braben, Ian Bell</developer>
		<publisher>Imagineer Co., Ltd.</publisher>
		<genre>Action, Shooter</genre>
	</game>

• Quindi il percorso completo della miniatura sarebbe: ./EmulationStation/downloaded_images/nes/covers/Elite-thumb.jpg

6. A questo punto la configurazione è terminata. Collegare la memoria esterna alla Xbox e avviare RetroPass. Seguire la sezione Prima esecuzione e Impostazioni.

Prima esecuzione e impostazioni

1. Se il file di configurazione di RetroPass viene trovato e configurato correttamente, viene visualizzata la schermata Settings:

1. Fare clic sul pulsante Activate e quindi su Back.
2. Dovreste vedere un elenco di piattaforme e contenuti:
   • Elimina la cache elimina tutte le miniature memorizzate nella cache, ma anche la playlist Riproduci più tardi.
   • Auto Play Video riproduce automaticamente un video quando viene selezionato il contenuto.
   • Abilita registrazione abilita la registrazione. Vedere la sezione Risoluzione dei problemi per maggiori informazioni.

Controlli

• – Conferma.
• – Indietro, schermata precedente, chiusura finestra di dialogo.
•  – Aggiungi/rimuovi titolo da/alla playlist Riproduci più tardi.
• – Mostra la schermata di ricerca.
• / – Apre la schermata Registro, solo nella schermata Settings.
• Menu/Start – Avvia immediatamente il contenuto, funziona nella schermata principale e nella schermata Collection.

Risoluzione dei problemi

Se dopo l’installazione e la configurazione non vedi i tuoi contenuti:

1. Andare su Settings e selezionare Enable Logging.
2. Uscire da RetroPass e riavviarlo.
3. Andare su Settings e premere il pulsante () sul gamepad Xbox.
4. Visualizzare il registro e notare le voci di registro di avviso giallo e di errore rosso.
5. Il file di registro viene generato anche nella cartella RetroPass locale su Xbox

Assicurati di disattivare la registrazione dopo la risoluzione dei problemi, perché la scrittura in un file di registro rallenta le prestazioni dell’app.

Cache delle miniature

• RetroPass utilizza il proprio sistema di memorizzazione nella cache delle miniature, quindi ha un controllo esplicito sulle miniature memorizzate nella cache e sulla memoria utilizzata. La memorizzazione nella cache delle miniature di Windows nativa non viene utilizzata.
• Le miniature memorizzate nella cache possono essere eliminate aprendo la pagina Settings e facendo clic sul pulsante Delete Cache.
• Quando le immagini del front box devono essere mostrate per la prima volta, vengono prima memorizzate nella cache in una miniatura più piccola per un caricamento più rapido in seguito. Ciò significa che quando accedi alle raccolte della piattaforma, il caricamento delle immagini sarà più lento fino alla generazione delle miniature.
• Al momento, non esiste una gestione della memoria per le miniature mostrate. Le miniature caricate rimangono in memoria fino alla chiusura dell’app. Ciò rende davvero veloce la visualizzazione delle raccolte una volta caricate, ma potrebbe potenzialmente arrestare l’app in modo anomalo se è presente un numero elevato di sistemi con raccolte enormi.

Changelog

• Quando si utilizza LaunchBox, le playlist e le piattaforme possono essere riordinate utilizzando il parametro “Sort Title”.
• Modificato il primo messaggio relativo alla configurazione XML mancante, aggiunto collegamento alle istruzioni di configurazione.

Download: RetroPass v1.5.0

Download: Source code RetroPass v1.5.0

Fonte: github.com