chrome.mediaGalleries

คำอธิบาย

ใช้ chrome.mediaGalleries API เพื่อเข้าถึงไฟล์สื่อ (เสียง รูปภาพ วิดีโอ) จากดิสก์ในเครื่องของผู้ใช้ (เมื่อได้รับความยินยอมจากผู้ใช้)

สิทธิ์

mediaGalleries

ประเภท

AddGalleryWatchResult

พร็อพเพอร์ตี้

  • galleryId

    สตริง

  • สำเร็จ

    boolean

GalleryChangeDetails

พร็อพเพอร์ตี้

  • galleryId

    สตริง

    ระบุแกลเลอรีที่แก้ไขแล้ว

  • ประเภท

    GalleryChangeType

    ประเภทของเหตุการณ์การเปลี่ยนแปลง

GalleryChangeType

ค่าแจกแจง

"contents_changed"
เนื้อหาแกลเลอรีมีการเปลี่ยนแปลง

"watch_dropped"
นาฬิกาตกหล่นเนื่องจากถอดอุปกรณ์ออก นำสิทธิ์แกลเลอรีออก หรือด้วยเหตุผลอื่นใด

GetMediaFileSystemsInteractivity

ค่าแจกแจง

"no"
อย่าโต้ตอบ

"yes"
ขอให้ผู้ใช้จัดการแกลเลอรีสื่อที่ได้รับอนุญาต

"if_needed"
ขอให้ผู้ใช้จัดการแกลเลอรีที่ได้รับอนุญาตในกรณีที่ชุดการแสดงผลจะว่างเปล่าเท่านั้น

GetMetadataType

ค่าแจกแจง

"all"
เรียกข้อมูลประเภท MIME, แท็กข้อมูลเมตา และรูปภาพที่แนบ

"mimeTypeAndTags"
เรียกข้อมูลเฉพาะประเภท MIME และแท็กข้อมูลเมตา

"mimeTypeOnly"
เรียกข้อมูลเฉพาะประเภท MIME

MediaFileSystemMetadata

พร็อพเพอร์ตี้

  • deviceId

    string ไม่บังคับ

    หากแกลเลอรีสื่ออยู่ในอุปกรณ์ที่นำออกได้ รหัสที่ไม่ซ้ำกันสำหรับอุปกรณ์ขณะที่อุปกรณ์ออนไลน์อยู่

  • galleryId

    สตริง

    รหัสแบบถาวรที่ไม่ซ้ำกันสำหรับแกลเลอรีสื่อ

  • ว่าง

    boolean

    เป็นจริงหากอุปกรณ์พร้อมใช้งานในขณะนี้

  • isMediaDevice

    boolean

    เป็นจริงหากตรวจพบว่าอุปกรณ์ที่แกลเลอรีสื่อเปิดอยู่เป็นอุปกรณ์สื่อ เช่น มีอุปกรณ์ PTP หรือ MTP หรือไดเรกทอรี DCIM

  • isRemovable

    boolean

    เป็นจริงหากแกลเลอรีสื่ออยู่ในอุปกรณ์ที่นำออกได้

  • ชื่อ

    สตริง

    ชื่อระบบไฟล์

MediaFileSystemsDetails

พร็อพเพอร์ตี้

  • อินเทอร์แอกทีฟ

    GetMediaFileSystemsInteractivity ไม่บังคับ

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

MediaMetadata

พร็อพเพอร์ตี้

  • อัลบั้ม

    string ไม่บังคับ

    กำหนดไว้สำหรับเสียงและวิดีโอ

  • ศิลปิน

    string ไม่บังคับ

  • attachedImages

    BLOB[]

    รูปภาพที่ฝังอยู่ในข้อมูลเมตาของไฟล์สื่อ มักใช้กับปกอัลบั้มหรือภาพขนาดย่อของวิดีโอ

  • ความคิดเห็น

    string ไม่บังคับ

  • ลิขสิทธิ์

    string ไม่บังคับ

  • disc

    หมายเลข ไม่บังคับ

  • ระยะเวลา

    หมายเลข ไม่บังคับ

    กำหนดไว้สำหรับเสียงและวิดีโอ ในหน่วยวินาที

  • แนวเพลง

    string ไม่บังคับ

  • ส่วนสูง

    หมายเลข ไม่บังคับ

    กำหนดไว้สำหรับวิดีโอ เป็นพิกเซล

  • ภาษา

    string ไม่บังคับ

  • mimeType

    สตริง

    ประเภท Sniffed ประเภท MIME ของเบราว์เซอร์

  • rawTags

    StreamInfo[]

    ข้อมูลเมตาทั้งหมดในไฟล์สื่อ สำหรับรูปแบบที่มีหลายสตรีม ระบบจะคงลำดับสตรีมไว้ ข้อมูลเมตาของคอนเทนเนอร์เป็นองค์ประกอบแรก

  • การหมุน

    หมายเลข ไม่บังคับ

    กำหนดไว้สำหรับวิดีโอ เป็นองศา

  • title

    string ไม่บังคับ

  • แทร็ก

    หมายเลข ไม่บังคับ

  • ความกว้าง

    หมายเลข ไม่บังคับ

MediaMetadataOptions

พร็อพเพอร์ตี้

  • metadataType

    GetMetadataType ไม่บังคับ

    ระบุว่าจะเรียกชุดย่อยใดของข้อมูลเมตา ค่าเริ่มต้นคือ "all" หากไม่ใส่ตัวเลือก

StreamInfo

พร็อพเพอร์ตี้

  • แท็ก

    ออบเจ็กต์

    พจนานุกรมสตริง->สตริงที่ไม่มีการกรองของแท็กสำหรับสตรีม

  • ประเภท

    สตริง

    อธิบายรูปแบบของคอนเทนเนอร์หรือตัวแปลงรหัสของสตรีม เช่น "mp3", "h264"

เมธอด

addGalleryWatch()

สัญญา 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

เพิ่มนาฬิกาแกลเลอรีที่มีรหัสแกลเลอรีที่ระบุ Callback ที่ระบุจะเริ่มทำงานพร้อมกับผลลัพธ์ที่สำเร็จหรือล้มเหลว

พารามิเตอร์

  • galleryId

    สตริง

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (result: AddGalleryWatchResult) => void

การคืนสินค้า

  • Promise<AddGalleryWatchResult>

    Chrome 116 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      สตริง

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

รับข้อมูลเมตาเกี่ยวกับระบบไฟล์สื่อที่ระบุ

พารามิเตอร์

  • mediaFileSystem

    DOMFileSystem

การคืนสินค้า

getMediaFileSystems()

สัญญา 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

รับแกลเลอรีสื่อที่กำหนดค่าใน User Agent นี้ ถ้าไม่มีการกำหนดค่าหรือไม่พร้อมใช้งาน การเรียกกลับจะได้รับอาร์เรย์ที่ว่างเปล่า

พารามิเตอร์

  • รายละเอียด

    MediaFileSystemsDetails ไม่บังคับ

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

การคืนสินค้า

  • Promise<DOMFileSystem[]>

    Chrome 116 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getMetadata()

สัญญา 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

รับข้อมูลเมตาเฉพาะสื่อสำหรับไฟล์สื่อ วิธีนี้เหมาะสำหรับไฟล์ในแกลเลอรีสื่อและระบบไฟล์ DOM อื่นๆ

พารามิเตอร์

  • mediaFile

    Blob

  • ตัวเลือก

    MediaMetadataOptions ไม่บังคับ

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (metadata: MediaMetadata) => void

การคืนสินค้า

  • Promise<MediaMetadata>

    Chrome 116 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

นำนาฬิกาแกลเลอรีที่มีรหัสแกลเลอรีที่ระบุออก

พารามิเตอร์

  • galleryId

    สตริง

กิจกรรม

onGalleryChanged

chrome.mediaGalleries.onGalleryChanged.addListener(
  callback: function,
)

เริ่มทำงานเมื่อแกลเลอรีสื่อมีการเปลี่ยนแปลงหรือนาฬิกาแกลเลอรีตกหล่น

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (details: GalleryChangeDetails) => void