Steamworks 문서
Steam 스크린샷

개요

스크린샷 지원은 Steam의 Steam 오버레이 기능을 통해 모든 게임에 자동으로 제공되며 Steamworks는 이 시스템과 상호작용하기 위해 설계된 일련의 API를 제공합니다. Steamworks 스크린샷 API는 스크린샷을 촬영하고 임의 지역명이나 스크린샷에 등장하는 사용자를 태그하는 것과 같은 추가 메타데이터를 사용자의 로컬 스크린샷 라이브러리에 추가할 수 있게 해줍니다.
참고: 게임에서 스크린샷을 사용하려면 Steam 오버레이 기능이 활성화되어 있어야 합니다.

사용자는 Steam에서 제어하는 단축키(기본 설정은 F12)를 눌러 스크린샷을 촬영할 수 있습니다.

사용자는 '설정' -> '게임 내'로 이동하여 Steam에서 플레이하는 모든 게임에 적용되는 단축키 및 기타 스크린샷 설정을 변경할 수 있습니다.

screenshot_hotkey.png

스크린샷 업로더

게임을 종료하면 이전 게임 세션에서 촬영한 모든 스크린샷과 함께 스크린샷 업로더가 자동으로 실행됩니다. 이 기능을 비활성화하려면 '설정' -> '클라우드'로 이동하여 '스크린샷을 촬영한 경우 게임 종료 후 스크린샷 업로더 실행’의 확인란을 선택 해제해야 합니다.

screenshot_uploader.png

Steam에서 '보기' -> '스크린샷'으로 이동하거나 Steam 오버레이에서 '스크린샷'을 클릭하면 스크린샷 업로더를 사용할 수 있습니다.

사용자가 업로드한 스크린샷은 커뮤니티 프로필과 귀사의 게임 커뮤니티 허브에서 볼 수 있습니다.

Steam 스크린샷 API

Steamworks SDK는 ISteamScreenshots에 대한 접근을 제공하며, 고객에게 최고의 경험을 제공하기 위해 고급 기능과 함께 Steam 스크린샷 시스템을 게임에 바로 통합할 수 있도록 지원합니다.

스크린샷 촬영은 Steam이 처리하는 것이 기본이지만, ISteamScreenshots::HookScreenshots로 스크린샷을 연결하면 이를 직접 제어할 수 있습니다. 스크린샷을 연결한 경우 사용자가 스크린샷 단축키를 누르면 ScreenshotRequested_t 콜백을 받게됩니다. 현재 스크린샷이 연결되어 있는지 여부는 ISteamScreenshots::IsScreenshotsHooked를 통해 확인할 수 있습니다.

연결 여부와 상관없이 스크린샷이 성공적으로 디스크에 저장되면 ScreenshotReady_t 콜백을 받게 됩니다. 이 콜백을 받고 나면 결과를 확인해야 하며, 성공적인 경우에는 제공된 ScreenshotHandle을 사용하여 태그를 설정할 수 있습니다.

나만의 버튼으로 스크린샷을 촬영하거나 게임 라운드 종료와 같은 특정 시점에 자동으로 촬영하고 싶다면, ISteamScreenshots::TriggerScreenshot으로 프로그래밍하거나, ISteamScreenshots::WriteScreenshot으로 RGB 바이트를 작성하거나, ISteamScreenshots::AddScreenshotToLibrary/ISteamScreenshots::AddVRScreenshotToLibrary으로 디스크에 파일을 추가하여 기능을 설정할 수 있습니다.