캡처 서비스 는 개발자가 스크린샷 캡처 기능이 경험과 어떻게 통합되는지 제어할 수 있는 클라이언트 측 서비스입니다.사용자에게 자동으로 스크린샷이 캡처되고 해당 사용자가 스크린샷을 저장, 공유 또는 삭제할 수 있는 미리 설정된 순간을 포함하는 데 사용할 수 있습니다.
요약
메서드
스크린샷을 찍고 임시 contentId를 제공하여 식별합니다.
사용자에게 지정된 캡처를 갤러리에 저장하도록 요청합니다.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
사용자에게 지정된 스크린샷 캡처를 공유하도록 요청합니다.
- StartVideoCaptureAsync(onCaptureReady : function,captureParams : Dictionary):Enum.VideoCaptureResult
이벤트
캡처가 시작되기 전에 즉시 발생합니다.
캡처가 완료된 후 발생하는 화재.
사용자가 캡처를 저장할 때 발생합니다.
속성
메서드
CaptureScreenshot
이 메서드는 사용자에 대한 스크린샷을 캡처하지만 경험의 메인 메뉴 내에서 캡처 갤러리에 즉시 저장하지 않습니다.대신, 새로운 캡처를 식별하기 위해 임시 contentId 가 생성됩니다.
onCaptureReady 콜백을 사용하여 사용자에게 스크린샷을 저장하거나 공유하도록 요청할 수 있습니다.
local CaptureService = game:GetService("CaptureService")
-- 이 코드가 포함된 스크립트의 이미지레이블 부모에 대한 참조
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
매개 변수
준비되면 새 캡처의 contentId로 호출되는 콜백 함수.
반환
PromptSaveCapturesToGallery
이 메서드는 제공된 contentIds에 의해 식별된 스크린샷을 경험의 메인 메뉴 내 캡처 갤러리에 저장하도록 사용자에게 요청합니다.
매개 변수
사전 매핑을 통해 각 contentId에 사용자가 캡처를 저장하는 것을 수락했는지 여부를 나타내는 불리언을 호출하는 콜백 함수.
반환
PromptShareCapture
이 메서드는 제공된 contentId 기본 공유 시트를 사용하여 장치에서 식별된 스크린샷을 공유하도록 사용자를 요청합니다.
지원되는 경우 캡처 이미지는 경험에 대한 초대 링크와 함께 공유됩니다.모든 장치에서 스크린샷과 초대 링크를 모두 지원하지는 않습니다.
launchData 는 초대 링크를 통해 가입하는 사용자의 launchData 필드에서 사용할 수 있습니다.
이 메서드를 호출할 때 오류를 방지하려면 PolicyService:GetPolicyInfoForPlayerAsync() 을 먼저 호출하고 반환된 사전에서 IsContentSharingAllowed 가 올바른지 확인하십시오.
매개 변수
초대 링크에 런칭 데이터로 포함할 선택적 문자열.
사용자가 공유를 수락하면 선택적 콜백 함수가 호출됩니다.
사용자가 공유를 거부하면 선택적 콜백 함수가 호출됩니다.
반환
StopVideoCapture
반환
StartVideoCaptureAsync
매개 변수
반환
이벤트
CaptureBegan
이 이벤트는 새 스크린샷 캡처가 수행되기 바로 전에 발생합니다.예를 들어 특정 GUI 요소를 숨겨 캡처 경험을 사용자 지정할 수 있습니다.
CaptureEnded
이 이벤트는 새 스크린샷 캡처가 완료된 후 발생합니다. 이 이벤트가 발생했을 때 수행된 모든 변경 사항을 복원하는 데 사용할 수 있습니다.
UserCaptureSaved
이 이벤트는 사용자가 Roblox 스크린샷 캡처 UI를 사용하여 스크린샷을 저장할 때 발생합니다.분석에 사용하거나 사용자에게 캡처를 공유하도록 요청할 수 있습니다.
매개 변수
사용자가 저장한 스크린샷을 식별하는 contentId