chrome.mediaGalleries

คำอธิบาย

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

สิทธิ์

mediaGalleries

ประเภท

AddGalleryWatchResult

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

• galleryId

  string

• สำเร็จ

  boolean

GalleryChangeDetails

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

• galleryId

  string

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

• ประเภท

  GalleryChangeType

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

GalleryChangeType

ค่าแจกแจง

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

"watch_dropped"
นาฬิกาตกหล่นเพราะอุปกรณ์ถูกถอดออก นำสิทธิ์แกลเลอรีออกแล้ว หรือด้วยสาเหตุอื่นๆ

GetMediaFileSystemsInteractivity

ค่าแจกแจง

"ไม่"
ห้ามกระทำการในการโต้ตอบ

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

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

GetMetadataType

ค่าแจกแจง

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

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

"mimeTypeOnly"
ดึงเฉพาะประเภท MIME

MediaFileSystemMetadata

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

• deviceId

  string ไม่บังคับ

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

• galleryId

  string

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

• isAvailable

  boolean

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

• isMediaDevice

  boolean

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

• isRemovable

  boolean

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

• ชื่อ

  string

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

MediaFileSystemsDetails

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

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

  GetMediaFileSystemsInteractivity ไม่บังคับ

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

MediaMetadata

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

• อัลบั้ม

  string ไม่บังคับ

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

• ศิลปิน

  string ไม่บังคับ

• attachedImages

  หยด[]

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

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

  string ไม่บังคับ

• ลิขสิทธิ์

  string ไม่บังคับ

• disc

  ตัวเลข ไม่บังคับ

• ระยะเวลา

  ตัวเลข ไม่บังคับ

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

• แนวเพลง

  string ไม่บังคับ

• ส่วนสูง

  ตัวเลข ไม่บังคับ

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

• ภาษา

  string ไม่บังคับ

• mimeType

  string

  เบราว์เซอร์ดักฟังประเภท MIME

• rawTags

  StreamInfo[]

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

• การหมุน

  ตัวเลข ไม่บังคับ

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

• title

  string ไม่บังคับ

• ติดตาม

  ตัวเลข ไม่บังคับ

• ความกว้าง

  ตัวเลข ไม่บังคับ

MediaMetadataOptions

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

• metadataType

  GetMetadataType ไม่บังคับ

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

StreamInfo

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

• แท็ก

  ออบเจ็กต์

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

• ประเภท

  string

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

วิธีการ

addGalleryWatch()

สัญญา

chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

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

พารามิเตอร์

• galleryId

  string

• Callback

  ฟังก์ชัน ไม่บังคับ

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

  (result: AddGalleryWatchResult)=>void

  • ผลลัพธ์

    AddGalleryWatchResult

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

• Promise<AddGalleryWatchResult>

  Chrome 116 ขึ้นไป

  Promiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

พารามิเตอร์

• Callback

  ฟังก์ชัน

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

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

  • mediaFileSystems

    ระบบ DOMFile[]

  • selectedFileSystemName

    string

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

พารามิเตอร์

• mediaFileSystem

  DOMFileSystem

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

• MediaFileSystemMetadata|ไม่ระบุ

getMediaFileSystems()

สัญญา

chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

พารามิเตอร์

• รายละเอียด

  MediaFileSystemsDetails ไม่บังคับ

• Callback

  ฟังก์ชัน ไม่บังคับ

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

  (mediaFileSystems: DOMFileSystem[])=>void

  • mediaFileSystems

    ระบบ DOMFile[]

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

• Promise<DOMFileSystem[]>

  Chrome 116 ขึ้นไป

  Promiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ

getMetadata()

สัญญา

chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

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

พารามิเตอร์

• mediaFile

  Blob

• ตัวเลือก

  MediaMetadataOptions ไม่บังคับ

• Callback

  ฟังก์ชัน ไม่บังคับ

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

  (metadata: MediaMetadata)=>void

  • ข้อมูลเมตา

    MediaMetadata

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

• Promise<MediaMetadata>

  Chrome 116 ขึ้นไป

  Promiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

พารามิเตอร์

• galleryId

  string

กิจกรรม

onGalleryChanged

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

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

พารามิเตอร์

• Callback

  ฟังก์ชัน

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

  (details: GalleryChangeDetails)=>void

  • รายละเอียด

    GalleryChangeDetails