Dokumentasi Steamworks
Screenshot Steam

Ringkasan

Dukungan screenshot tersedia secara otomatis melalui Overlay Steam untuk setiap game melalui Steam dan Steamworks menyediakan satu set API yang didesain untuk berinteraksi dengan sistem ini. API screenshot Steamworks memungkinkanmu untuk mengambil screenshot dan menambahkannya ke perpustakaan screenshot lokal pengguna dengan metadata tambahan, seperti nama lokasi dalam game-mu atau memberikan tanda pada pengguna yang ada di screenshot.
CATATAN: Overlay Steam harus aktif di game-mu agar sistem Screenshot dapat digunakan.

Pengguna dapat menekan tombol pintas yang dikontrol oleh Steam (default-nya adalah F12) untuk mengambil screenshot.

Pengguna dapat mengubah tombol pintas dan pengaturan screenshot lainnya yang akan berlaku di segala game yang mereka mainkan dengan membuka Pengaturan -> Dalam Game.

screenshot_hotkey.png

Pengunggah Screenshot

Setelah keluar dari game, Pengunggah Screenshot akan terbuka secara otomatis dan menunjukkan semua screenshot yang diambil dari sesi yang baru dimainkan. Pengguna dapat menonaktifkan perilaku ini dengan membuka Pengaturan -> Cloud dan menghapus centang "Buka pengunggah screenshot setelah menutup game jika ada screenshot yang diambil".

screenshot_uploader.png

Pengunggah Screenshot juga dapat diakses kapan pun melalui Steam dengan membuka Lihat -> Screenshot, atau dengan mengeklik "Screenshot" di Overlay Steam.

Jika pengguna mengunggah screenshot, maka screenshot tersebut akan terlihat di profil komunitas mereka dan di hub komunitas game-mu.

API Screenshot Steam

SDK Steamworks menyediakan akses ke ISteamScreenshots, dan memungkinkanmu untuk menggunakan fitur-fitur tingkat lanjutan dan mengintegrasikan sistem Screenshot Steam ke game-mu untuk memberikan pengalaman terbaik bagi pelangganmu.

Secara default, Steam akan menangani pengambilan screenshot, tapi kamu dapat mengontrolnya dengan mengaitkan screenshot menggunakan ISteamScreenshots::HookScreenshots. Jika kamu mengaitkan screenshot, kamu akan mendapatkan callback ScreenshotRequested_t ketika pengguna menekan tombol pintas untuk screenshot. Kamu dapat memeriksa jika kamu mengaitkan screenshot dengan ISteamScreenshots::IsScreenshotsHooked.

Terlepas dari jika kamu mengaitkan screenshot atau tidak, kamu akan mendapatkan callback ScreenshotReady_t ketika screenshot telah berhasil disimpan ke disk. Periksa hasilnya setelah menerima callback ini, dan jika berhasil, kamu bisa menggunakan ScreenshotHandle yang telah disediakan untuk mengatur tag dengan:

Jika kamu ingin mengambil screenshot baik menggunakan tombolmu sendiri atau secara otomatis di beberapa titik tertentu, seperti saat ronde berakhir, kamu dapat melakukannya secara terprogram dengan ISteamScreenshots::TriggerScreenshot atau dengan menulis byte RGB dengan ISteamScreenshots::WriteScreenshot, atau dengan menambahkan file dari disk dengan ISteamScreenshots::AddScreenshotToLibrary/ISteamScreenshots::AddVRScreenshotToLibrary.