Tài liệu Steamworks
Ảnh chụp màn hình Steam

Tổng quan

Hỗ trợ chụp màn hình được cung cấp tự động bởi Lớp phủ Steam cho tất cả trò chơi thông qua Steam. Steamworks cũng có một bộ API được thiết kế để tương tác với hệ thống này. API ảnh chụp màn hình Steam cho phép chụp màn hình và thêm vào thư viện ảnh chụp của người dùng kèm metadata bổ sung, như tên của vị trí trong trò chơi hay gắn thẻ người dùng xuất hiện trong ảnh đó.
LƯU Ý: Lớp phủ Steam phải được kích hoạt trong trò chơi của bạn để hệ thống chụp hình hoạt động.

Người dùng có thể ấn phím tắt điều khiển bởi Steam (Mặc định F12), để chụp ảnh màn hình.

Người dùng có thể đổi phím tắt này và các thiết lập chụp màn hình khác với bất kỳ trò chơi nào trên Steam bằng cách vào Thiết lập-> Trong khi chạy.

screenshot_hotkey.png

Trình tải lên ảnh chụp

Sau khi thoát trò chơi, công cụ tải ảnh chụp sẽ tự động mở với toàn bộ các ảnh đã chụp trong phiên trước đó. Người dùng có thể tắt hành vi này bằng cách vào Thiết lập -> Cloud và bỏ chọn "Mở công cụ tải ảnh chụp lên sau khi đóng trò chơi nếu có ảnh chụp".

screenshot_uploader.png

Có thể bật công cụ tải ảnh chụp bất kỳ lúc nào qua Steam bằng cách vào Hiển thị -> Ảnh chụp màn hình hoặc nhấp vào "Xem ảnh chụp" trong lớp phủ Steam.

Ảnh chụp do người dùng đăng tải sẽ hiện lên hồ sơ cộng đồng của họ và trung tâm cộng đồng cho trò chơi.

API ảnh chụp màn hình Steam

Steamworks SDK cho truy cập tới ISteamScreenshots, và cho phép bạn dùng các tính năng nâng cao và tích hợp hệ thống ảnh chụp Steam vào ngay trong trò chơi để mang tới trải nghiệm tốt nhất cho khách hàng.

Theo mặc định, Steam sẽ xử lý việc chụp ảnh màn hình, nhưng bạn có thể kiểm soát bằng cách hook ảnh chụp với ISteamScreenshots::HookScreenshots. Nếu hook ảnh chụp, bạn sẽ nhận một callback ScreenshotRequested_t khi người dùng ấn phím chụp ảnh. Bạn có thể kiểm tra xem mình hiện có đang hook ảnh chụp hay không với ISteamScreenshots::IsScreenshotsHooked.

Cho dù bạn đang hook hay không, bạn sẽ nhận một callback từ ScreenshotReady_t khi ảnh chụp đã lưu vào ổ đĩa thành công. Sau khi nhận callback này bạn nên kiểm tra kết quả, và nếu thành công, bạn có thể dùng ScreenshotHandle được cung cấp để gán nhãn với:

Nếu muốn chụp ảnh với nút của riêng mình hoặc tự động vào một thời điểm nào đó như cuối ván đấu chẳng hạn, bạn có thể lập trình với ISteamScreenshots::TriggerScreenshot hoặc bằng cách viết các byte RGB với ISteamScreenshots::WriteScreenshot, hoặc thêm một file vào ổ đĩa với ISteamScreenshots::AddScreenshotToLibrary/ISteamScreenshots::AddVRScreenshotToLibrary.