คำอธิบาย
Desktop Capture API จะบันทึกเนื้อหาของหน้าจอ หน้าต่างแต่ละบาน หรือแต่ละแท็บ
สิทธิ์
desktopCapture
ประเภท
DesktopCaptureSourceType
Enum ที่ใช้กำหนดชุดแหล่งที่มาของสื่อเดสก์ท็อปที่ใช้ใน selectDesktopMedia()
ค่าแจกแจง
ค่าแจกแจง
"exclude"
ค่าแจกแจง
"exclude"
วิธีการ
cancelChooseDesktopMedia()
chrome.desktopCapture.cancelChooseDesktopMedia(
desktopMediaRequestId: number,
)
ซ่อนกล่องโต้ตอบเครื่องมือเลือกสื่อบนเดสก์ท็อปที่แสดงโดย chooseDesktopMedia()
พารามิเตอร์
-
desktopMediaRequestId
ตัวเลข
รหัสที่แสดงผลโดย selectDesktopMedia()
chooseDesktopMedia()
chrome.desktopCapture.chooseDesktopMedia(
sources: DesktopCaptureSourceType[],
targetTab?: Tab,
callback: function,
)
แสดง UI เครื่องมือเลือกสื่อบนเดสก์ท็อปพร้อมชุดแหล่งที่มาที่ระบุ
พารามิเตอร์
-
แหล่งที่มา
ชุดแหล่งที่มาที่ควรแสดงต่อผู้ใช้ ลำดับแหล่งที่มาในชุดจะกำหนดลำดับแท็บในเครื่องมือเลือก
-
targetTab
Tab ไม่บังคับ
แท็บตัวเลือกสำหรับการสร้างสตรีม หากไม่ระบุ สตรีมผลลัพธ์จะสามารถใช้ได้โดยส่วนขยายการโทรเท่านั้น สตรีมจะใช้ได้โดยเฟรมในแท็บที่ระบุซึ่งมีต้นทางความปลอดภัยตรงกับ
tab.url
เท่านั้น ต้นทางของแท็บต้องเป็นต้นทางที่ปลอดภัย เช่น HTTPS -
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(streamId: string, options: object) => void
-
streamId
string
สตริงทึบที่ส่งไปยัง
getUserMedia()
API เพื่อสร้างสตรีมสื่อที่สอดคล้องกับแหล่งที่มาที่ผู้ใช้เลือกได้ หากผู้ใช้ไม่ได้เลือกแหล่งที่มาใดๆ (เช่น ยกเลิกข้อความแจ้งแล้ว) ระบบจะเรียกใช้โค้ดเรียกกลับโดยมีstreamId
ที่ว่างเปล่าstreamId
ที่สร้างจะใช้ได้เพียงครั้งเดียวและหมดอายุหลังจากผ่านไป 2-3 วินาทีเมื่อไม่มีการใช้งาน -
ตัวเลือก
ออบเจ็กต์
Chrome 57 ขึ้นไปประกอบด้วยพร็อพเพอร์ตี้ที่อธิบายสตรีม
-
canRequestAudioTrack
boolean
เป็นจริงหาก "เสียง" รวมอยู่ในแหล่งที่มาของพารามิเตอร์ และผู้ใช้ปลายทางไม่ได้ยกเลิกการเลือกช่องทำเครื่องหมาย "แชร์เสียง" ไม่เช่นนั้นจะเป็นเท็จ และในกรณีนี้ ไม่ควรขอให้สตรีมเสียงผ่านการเรียก getUserMedia
-
-
การคืนสินค้า
-
ตัวเลข
รหัสที่สามารถส่งผ่านเพื่อ cancelChooseDesktopMedia() ในกรณีที่ต้องยกเลิกข้อความแจ้ง