Steamworks dokumentáció
Steam képernyőmentések

Áttekintés

A képernyőmentés-támogatás automatikusan biztosított az Átfedésen keresztül minden játékhoz a Steamen, a Steamworks pedig egy sor API-t biztosít az interakcióhoz ezzel a rendszerrel. A Steamworks Képernyőmentés API lehetővé teszi képernyőmentések készítését és hozzáadását a felhasználók helyi képernyőmentés-könyvtárához további metaadatokkal, például egy játékodban levő helyszín nevével vagy a képernyőmentésen látható felhasználók címkézésével.
MEGJEGYZÉS: ahhoz, hogy a képernyőmentés rendszer elérhető legyen, a Steam Átfedésnek aktívnak kell lennie a játékodban.

A felhasználók egy, a Steam által vezérelt gyorsbillentyű (alapértelmezetten az F12) megnyomásával tudnak képernyőmentést kezdeményezni.

A felhasználó a Steam -> Játékban kategóriában meg tudja változtatni a gyorsbillentyűt és más képernyőmentés-beállításokat, amelyek minden játékban érvényesek lesznek, amit a Steamen játszik.

screenshot_hotkey.png

Képernyőmentés-feltöltő

Egy játékból kilépéskor automatikusan megnyílik a Képernyőmentés-feltöltő, a megelőző munkamenet során készített összes képernyőképpel. A felhasználók ki tudják kapcsolni ezt a viselkedést a Beállítások -> Felhő kategóriában, törölve a „Képernyőmentés-kezelő megnyitása kilépés után, ha készültek képek.” lehetőség kijelölését.

screenshot_uploader.png

A képernyőmentés-feltöltő a Steamen keresztül bármikor elérhető a Nézet -> Képernyőmentések menüpontban is, vagy a „Képernyőmentésekre” kattintva a Steam Átfedésben.

Ha a felhasználó képernyőmentést tölt fel, az látható lesz a közösségi profiljában és a játékod közösségközpontjában.

Steam Képernyőmentések API

A Steamworks SDK hozzáférést biztosít az ISteamScreenshots-hoz, és lehetővé teszi speciális funkciók használatát, valamint a Steam Képernyőmentések rendszer integrálását közvetlenül a játékodba a legjobb vásárlói élményért.

Alapesetben a Steam kezeli a képernyőmentések készítését, de átveheted az irányítást, rákapcsolódva a képernyőmentésre az ISteamScreenshots::HookScreenshots használatával. Ha rákapcsolódsz a képernyőmentésre, kapni fogsz egy ScreenshotRequested_t callbacket, amikor a felhasználó megnyomja a képernyőmentés gyorsbillentyűt. Az ISteamScreenshots::IsScreenshotsHooked használatával tudod ellenőrizni, jelenleg rá vagy-e kapcsolódva a képernyőmentésekre.

Függetlenül attól, rá vagy-e kapcsolódva vagy sem, kapni fogsz egy ScreenshotReady_t callbacket, amikor a képernyőmentés sikeresen lemezre lett mentve. Miután megkaptad ezt a callbacket, érdemes ellenőrizned az eredményt, és ha sikeres volt, használni tudod a kapott ScreenshotHandle-t címkék beállítására a következőkkel:

Ha képernyőmentést akarsz készíteni akár a saját gomboddal, akár egy bizonyos ponton automatikusan, például egy kör végén, meg tudod tenni programozottan az ISteamScreenshots::TriggerScreenshot-tal, vagy az RGB bájtok kiírásával az ISteamScreenshots::WriteScreenshot-tal, vagy fájl lemezről hozzáadásával az ISteamScreenshots::AddScreenshotToLibrary/ISteamScreenshots::AddVRScreenshotToLibrary használatával.