CaptureService

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ไม่สามารถสร้าง
บริการ

บริการจับภาพ เป็นบริการฝั่งคลายที่ช่วยให้นักพัฒนาสามารถควบคุมวิธีที่คุณสมบัติการจับภาพสกรีนช็อตผสานกับประสบการณ์ของพวกเขาได้สามารถใช้เพื่อรวมช่วงเวลาที่การสกัดภาพถูกบันทึกโดยอัตโนมัติสำหรับผู้ใช้และผู้ใช้สามารถบันทึก แชร์ หรือลบภาพสกรีนช็อตได้

สรุป

วิธีการ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

คุณสมบัติ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

CaptureScreenshot

()

วิธีนี้จะบันทึกภาพหน้าจอสำหรับผู้ใช้ แต่ไม่บันทึกทันทีในแกลเลอรี การจับภาพ ภายในเมนูหลักของประสบการณ์แทนที่จะสร้างชั่วคราว contentId เพื่อระบุการจับใหม่

การโทรกลับ onCaptureReady สามารถใช้เพื่อเรียกให้ผู้ใช้บันทึกหรือแชร์ภาพหน้าจอ:

local CaptureService = game:GetService("CaptureService")



-- การอ้างถึงป้ายชื่อรูปภาพพ่อของสคริปที่มีรหัสนี้

local imageLabel = script.Parent



local function onCaptureReady(contentId)

	imageLabel.Image = contentId

end



CaptureService:CaptureScreenshot(onCaptureReady)

พารามิเตอร์

onCaptureReady: function

ฟังก์ชันการโทรกลับที่เรียกด้วย contentId ของการจับใหม่เมื่อพร้อม

ค่าเริ่มต้น: ""

ส่งค่ากลับ

()

PromptSaveCapturesToGallery

()

วิธีนี้จะขอให้ผู้ใช้บันทึกภาพหน้าจอที่ระบุโดย contentIds ที่ให้มาในแกลเลอรี การจับภาพ ภายในเมนูหลักของประสบการณ์

พารามิเตอร์

captures: Array
ค่าเริ่มต้น: ""
resultCallback: function

ฟังก์ชันการเรียกคืนที่จะถูกเรียกด้วยแผนที่ไดเรกทอรีแต่ละ contentId ไปยังบูลีนที่ระบุว่าผู้ใช้ยอมรับการบันทึกที่จับได้หรือไม่

ค่าเริ่มต้น: ""

ส่งค่ากลับ

()

PromptShareCapture

()

วิธีนี้จะขอให้ผู้ใช้แชร์ภาพหน้าจอที่ระบุโดยใช้แผ่นแชร์เดิมบนอุปกรณ์ของพวกเขาโดยใช้แผ่นแชร์เดิม

ภาพการจับถูกแชร์พร้อมกับลิงค์เชิญไปยังประสบการณ์เมื่อสนับสนุนแล้วไม่ใช่ทุกอุปกรณ์ที่สนับสนุนรวมถึงทั้งภาพหน้าจอและลิงก์เชิญ

ฟิลด์ launchData จะสามารถใช้งานได้ในฟิลด์ launchData สำหรับผู้ใช้ที่เข้าร่วมผ่านลิงก์เชิญ

เพื่อหลีกเลี่ยงข้อผิดพลาดเมื่อเรียกวิธีนี้ โทร PolicyService:GetPolicyInfoForPlayerAsync() ก่อนและตรวจสอบว่า IsContentSharingAllowed เป็นจริงในสารบัญที่ส่งคืน

พารามิเตอร์

captureContent: Content
ค่าเริ่มต้น: ""
launchData: string

สตริงที่เลือกได้เพื่อรวมเป็นข้อมูลการเปิดตัวในลิงก์เชิญ

ค่าเริ่มต้น: ""
onAcceptedCallback: function

ฟังก์ชันการโทรกลับทางเลือกที่เรียกใช้หากผู้ใช้ยอมรับการแบ่งปัน

ค่าเริ่มต้น: ""
onDeniedCallback: function

ฟังก์ชันการโทรกลับทางเลือกจะถูกเรียกหากผู้ใช้ปฏิเสธการแบ่งปัน

ค่าเริ่มต้น: ""

ส่งค่ากลับ

()

StopVideoCapture

()

ส่งค่ากลับ

()

TakeCapture

()

พารามิเตอร์

onCaptureReady: function
ค่าเริ่มต้น: ""
captureParams: Dictionary
ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

StartVideoCaptureAsync

Enum.VideoCaptureStartedResult
ผลตอบแทน

พารามิเตอร์

onCaptureReady: function
ค่าเริ่มต้น: ""
captureParams: Dictionary
ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

Enum.VideoCaptureStartedResult
ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

CaptureBegan

อีเวนต์นี้จะเกิดขึ้นทันทีก่อนที่จะบันทึกภาพหน้าจอใหม่สามารถใช้เพื่อปรับแต่งประสบการณ์การจับภาพ เช่น โดยการซ่อนองค์ประกอบ GUI บางอย่าง

พารามิเตอร์

captureType: Enum.CaptureType

CaptureEnded

อีเวนต์นี้จะเกิดขึ้นหลังจากการจับภาพสกรีนช็อตใหม่สําเร็จ สามารถใช้เพื่อฟื้นฟูการเปลี่ยนแปลงใดๆ ที่ทําเมื่อเหตุการณ์ CaptureBegan เกิดขึ้น

พารามิเตอร์

captureType: Enum.CaptureType

UserCaptureSaved

อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้บันทึกภาพหน้าจอโดยใช้อินเทอร์เฟซการจับภาพหน้าจอ Robloxสามารถใช้สำหรับการวิเคราะห์หรือเพื่อเรียกร้องให้ผู้ใช้แบ่งปันการจับภาพของพวกเขา

พารามิเตอร์

captureContentId: ContentId

The contentId ระบุภาพหน้าจอที่ผู้ใช้บันทึก


ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object