Yleiskatsaus
Voit käyttää Steam Workshopia määritysten luomiseen tai liittää pelin määritykset pakettina pelidepottiin. Pelidepottien määritysten paketoimisesta on hyötyä monella tapaa:
- Viralliset määritykset voidaan tallentaa Perforceen tai muihin versiohallintatyökaluihin.
- Määritysten hallinta pelin haarojen välillä tai julkisen ja yksityisen sovellustunnuksen välillä käy helpommin.
- Päivitykset ovat atomisia (jakamattomia), eivätkä vaadi kahta julkaisuvaihetta Steamworksissa.
Tiedostomuoto
Action manifest -tiedosto on
Pelinsisäisten toimintojen (IGA) -tiedosto -tiedoston laajennus, joka sisältää kaikista virallisista määrityksistä tyypin mukaan lajitellun listan:
"Action Manifest"
{
"configurations"
{
}
"actions"
{
}
"localization"
{
}
}
Lisätietoja toiminto- ja lokalisointiosioista löydät täältä:
Pelinsisäisten toimintojen (IGA) -tiedosto.
Määrityslista
Ohjainmääritysosiosta löytyvät määritykset ohjaintyypeittäin ja tärkeysjärjestyksessä lataamista varten. "Polku" riippuu Action Manifest -tiedoston sijainnista levylläsi.
"Action Manifest"
{
"configurations"
{
"controller_xboxone"
{
"0"
{
"path" "xbox_controller.vdf"
}
}
"controller_steamcontroller_gordon"
{
"0"
{
"path" "steam_controller.vdf"
}
"1"
{
"path" "steam_controller_motion_controls.vdf"
}
}
}
"actions"
{
}
"localization"
{
}
}
Tuetut merkkijonot ohjaintyypeille:
| Steam Deck -ohjain | controller_neptune |
| Steam Controller | controller_steamcontroller_gordon |
| Xbox 360 | controller_xbox360 |
| Xbox One | controller_xboxone |
| Xbox One Elite -ohjain | controller_xboxelite |
| PlayStation 4 -ohjain | controller_ps4 |
| PlayStation 5 -ohjain | controller_ps5 |
| Nintendo Switch Pro -ohjain | controller_switch_pro |
| Yleiset peliohjaimet | controller_generic |
Action Manifest -tiedoston luominen
Voit luoda Action Manifest -tiedoston joko aloittamalla tyhjästä tai käyttämällä olemassa olevaa IGA-tiedostoa.
Pelinsisäisten toimintojen tiedoston käyttö
Vaihe 1 – Steam-syötteen kehittäjätilan määrittäminen
Steam-syötteen kehittäjätila on otettava käyttöön ennen Action Manifest -tiedoston muokkaamista. Tämä tila mahdollistaa kehittäjälle määritysten viemisen ja virheilmoitusten saamisen, jos tiedostoa muokatessa sattuu vahinkoja.
1) Ota Steamin kehittäjätila käyttöön televisiotilassa kohdasta Asetukset > Järjestelmä.
2) Siirry kehittäjäosioon ja ota käyttöön Steam-syötteen asettelun kehittäjätila.
Vaihe 2 – Tallenna määritys
Jos sinulla on olemassa oleva IGA-tiedosto, voit tallentaa nykyiset määrityksesi ohjaimen määrityssivulla.
1) Klikkaa rataskuvaketta.
2) Valitse Vie asettelu -vaihtoehto.
3) Valitse pelisi nimi ja kuvaus ja vie asettelu.
Muistutus: Varmista, että olet määrittänyt lokalisointitunnukset Action Manifest -tiedostossa. Tee tämä kaikille kielille, joita pelisi tukee.
Vaihe 3 – Etsi määrityksesi
Käytä seuraavaa Steamin URL-osoitetta ja vie määritykset käyttöjärjestelmän mukaiseen tiedostokansioon (esim. Windowsin Omat tiedostot -kansio). URL:
Windowsin komentorivi
start steam://dumpcontrollerconfig?appid=X
Linuxin komentorivi
xdg-open steam://dumpcontrollerconfig?appid=X
Kopioi sekä määritys että olemassa oleva IGA-tiedosto haluamaasi sijaintiin pelikansiossa.
Vaihe 4 – Muunna IGA-tiedosto Action Manifest -tiedostoksi
Muuta IGA-tiedosto Action Manifest -tiedostoksi muokkaamalla tiedostoa ja lisäämällä siihen määritysosio, johon lisäät juuri viemäsi ohjainmäärityksen. Tässä esimerkki Steamworks SDK:sta:
"configurations"
{
"controller_xboxone"
{
"0"
{
"path" "xbox_controller.vdf"
}
}
"controller_steamcontroller_gordon"
{
"0"
{
"path" "steam_controller.vdf"
}
}
}
Vaihe 5 – Valitse Steamworksin asetukset
Valitse Steamworks-asetukset kumppanisivustolla siirtymällä Steamin syöteasetuksiin. Valitse sitten pudotusvalikosta Räätälöity määritys (pelin mukana) ja anna Action Manifest -tiedoston polku:
Action Manifest -tiedostoa käyttävän pelin virheenkorjaus
Kun suoritat pelin Steamissä, sen Action Manifest -tiedosto haetaan automaattisesti pelidepotista. Jos käytät asennettua peliä ohjelmointiympäristössä, Steam käyttää Steam-depotista peräisin olevaa Action Manifest -tiedostoa. Jos suoritat pelin, jota ei ole asennettu Steamiin tai sinun tarvitsee tehdä paikallisia muutoksia, voit ohittaa Action Manifest -polun API-kutsulla SetInputActionManifestPath. Steam muistaa tekemäsi valinnan pelisession loppuun asti. Tässä esimerkki API-kutsun käytöstä Steamworks SDK:ssa:
char rgchCWD[1024];
if ( !_getcwd( rgchCWD, sizeof( rgchCWD ) ) )
{
strcpy( rgchCWD, "." );
}
char rgchFullPath[1024];
#if defined(_WIN32)
_snprintf( rgchFullPath, sizeof( rgchFullPath ), "%s\\%s", rgchCWD, "steam_input_manifest.vdf" );
#elif defined(OSX)
_snprintf( rgchFullPath, sizeof( rgchFullPath ), "%s/steamworksexample.app/Contents/Resources/%s", rgchCWD, "steam_input_manifest.vdf" );
#else
_snprintf( rgchFullPath, sizeof( rgchFullPath ), "%s/%s", rgchCWD, "steam_input_manifest.vdf" );
#endif
SteamInput()->SetInputActionManifestFilePath( rgchFullPath );
