캡처 서비스 는 개발자가 스크린샷 캡처 기능이 경험과 어떻게 통합되는지 제어할 수 있는 클라이언트 측 서비스입니다.사용자에게 자동으로 스크린샷이 캡처되고 해당 사용자가 스크린샷을 저장, 공유 또는 삭제할 수 있는 미리 설정된 순간을 포함하는 데 사용할 수 있습니다.
요약
메서드
스크린샷을 찍고 임시 contentId를 제공하여 식별합니다.
사용자에게 지정된 캡처를 갤러리에 저장하도록 요청합니다.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
사용자에게 지정된 스크린샷 캡처를 공유하도록 요청합니다.
이벤트
캡처가 시작되기 전에 즉시 발생합니다.
캡처가 완료된 후 발생하는 화재.
사용자가 캡처를 저장할 때 발생합니다.
속성
메서드
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 가 올바른지 확인하십시오.
매개 변수
초대 연결런칭 데이터로 포함할 선택적 문자열.
사용자가 공유를 수락하면 선택적 콜백 함수가 호출됩니다.
사용자가 공유를 거부하면 선택적 콜백 함수가 호출됩니다.
반환
이벤트
CaptureBegan
이 이벤트는 새 스크린샷 캡처가 수행되기 바로 전에 발생합니다.예를 들어 특정 GUI 요소를 숨겨 캡처 경험을 사용자 지정할 수 있습니다.
CaptureEnded
이 이벤트는 새 스크린샷 캡처가 완료된 후 발생합니다. 이 이벤트가 발생했을 때 수행된 모든 변경 사항을 복원하는 데 사용할 수 있습니다.
UserCaptureSaved
이 이벤트는 사용자가 Roblox 스크린샷 캡처 UI를 사용하여 스크린샷을 저장할 때 발생합니다.분석에 사용하거나 사용자에게 캡처를 공유하도록 요청할 수 있습니다.
매개 변수
사용자가 저장한 스크린샷을 식별하는 contentId