스크린 샷 캡처 서비스 는 개발자가 스크린 샷 스크린샷기능이 경험과 통합되는 방법을 제어하도록 하는 클라이언트 사이드 서비스입니다. 이 서비스는 사용자에게 자동으로 스크린 샷이 찍힌 경우 저장, 공유 또는 삭제할 수 있는 미리 설정 순간을
요약
메서드
스크린 샷을 찍고 임시 contentId를 제공하여 식별합니다.
사용자에게 지정된 캡처를 갤러리에 저장하라는 메시지를 표시합니다.
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
사용자에게 특정 스크린샷 캡처를 공유하라는 메시지를 표시합니다.
이벤트
캡처가 시작되기 전에 즉시 화재됩니다.
캡처가 완료된 후 화재됩니다.
사용자가 캡처를 저장할 때 화재됩니다.
속성
메서드
CaptureScreenshot
이 메서드는 사용자에게 스크린샷을 캡처하지만 즉시 경험의 메인 메뉴 내의 캡처 갤러리에 저장하지는 않습니다. 대신 임시 contentId 이 생성되어 새로운 캡처를 식별합니다.
onCaptureReady 콜백을 사용하여 사용자에게 스크린샷을 저장하거나 공유하라는 메시지를 표시할 수 있습니다.
local CaptureService = game:GetService("CaptureService")
-- 이 코드가 있는 스크립트의 ImageLabel 부모에 대한 참조
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
매개 변수
새로운 캡처가 준비되면 contentId 의 새로운 호출 함수.
반환
PromptSaveCapturesToGallery
이 메서드는 사용자가 제공된 contentIds로 식별된 스크린샷을 경험의 메인 메뉴에 있는 캡처 갤러리에 저장하도록 요청합니다.
매개 변수
저장할 스크린샷을 식별하는 배열의 문자열
사용자가 캡처를 저장할지 여부를 나타내는 변수를 매핑하는 마다 contentId 에 대해 호출되는 콜백 함수입니다.
반환
PromptShareCapture
이 메서드는 사용자가 제공된 contentId 를 사용하여 기기에서 식별된 스크린 샷을 공유하도록 요청합니다.
캡처 이미지는 지원되는 경우 경험과 함께 공유되며, 스크린샷과 초대 링크가 모든 디바이스/앱에서 지원되지는 않습니다.
사용자가 초대 연결통해 참여하는 사용자에게는 launchData 필드에 있습니다.
매개 변수
Content-ID 스크린샷을 공유하는 화면을 식별합니다.
초대 연결실행 데이터로 포함할 옵션 문자열입니다.
사용자가 공유를 수락하면 옵션 콜백 함수가 호출됩니다.
사용자가 공유를 거부하면 옵션 콜백 함수가 호출됩니다.
반환
이벤트
CaptureBegan
이 이벤트는 새로운 스크린샷 캡처가 수행될 때까지 즉시 발생합니다. 예를 들어, 특정 GUI 요소를 숨기거나 캡처 경험을 사용자 정의하는 데 사용될 수 있습니다.
CaptureEnded
이 이벤트는 새로운 스크린샷 캡처가 완료된 후 발생합니다. 이 이벤트는 CaptureBegan 이벤트가 발생한 후 변경 사항을 복원하는 데 사용할 수 있습니다.
UserCaptureSaved
이 이벤트는 Roblox 스크린샷 캡처 UI를 사용하여 사용자가 스크린샷을 저장할 때 발생합니다. 분석하거나 사용자가 캡처를 공유하도록 요청할 수 있습니다.
매개 변수
사용자가 저장한 스크린샷을 식별하는 contentId입니다.