chrome.desktopCapture

คำอธิบาย

Desktop Capture API จะบันทึกเนื้อหาของหน้าจอ หน้าต่างแต่ละบาน หรือแต่ละแท็บ

สิทธิ์

desktopCapture

ประเภท

DesktopCaptureSourceType

Enum ที่ใช้กำหนดชุดแหล่งที่มาของสื่อเดสก์ท็อปที่ใช้ใน selectDesktopMedia()

ค่าแจกแจง

SelfCapturePreferenceEnum

Chrome 107 ขึ้นไป

มิเรอร์ SelfCapturePreferenceEnum

ค่าแจกแจง

"exclude"

SystemAudioPreferenceEnum

Chrome 105 ขึ้นไป

มิเรอร์ SystemAudioPreferenceEnum

ค่าแจกแจง

"exclude"

วิธีการ

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

ซ่อนกล่องโต้ตอบเครื่องมือเลือกสื่อบนเดสก์ท็อปที่แสดงโดย chooseDesktopMedia()

พารามิเตอร์

• desktopMediaRequestId

  ตัวเลข

  รหัสที่แสดงผลโดย selectDesktopMedia()

chooseDesktopMedia()

chrome.desktopCapture.chooseDesktopMedia(
  sources: DesktopCaptureSourceType[],
  targetTab?: Tab,
  callback: function,
)

แสดง UI เครื่องมือเลือกสื่อบนเดสก์ท็อปพร้อมชุดแหล่งที่มาที่ระบุ

พารามิเตอร์

• แหล่งที่มา

  DesktopCaptureSourceType[]

  ชุดแหล่งที่มาที่ควรแสดงต่อผู้ใช้ ลำดับแหล่งที่มาในชุดจะกำหนดลำดับแท็บในเครื่องมือเลือก

• 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() ในกรณีที่ต้องยกเลิกข้อความแจ้ง