chrome.mediaGalleries

คำอธิบาย

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

สิทธิ์

mediaGalleries

ประเภท

AddGalleryWatchResult

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

  • galleryId

    สตริง

  • สำเร็จ

    บูลีน

GalleryChangeDetails

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

  • galleryId

    สตริง

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

  • ประเภท

    GalleryChangeType

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

GalleryChangeType

ค่าแจกแจง

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

"watch_dropped"
ระบบยกเลิกการเชื่อมต่อนาฬิกาเนื่องจากมีการถอดอุปกรณ์ออก นำสิทธิ์เข้าถึงแกลเลอรีออก หรือเหตุผลอื่นๆ

GetMediaFileSystemsInteractivity

ค่าแจกแจง

"ไม่"
ห้ามโต้ตอบ

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

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

GetMetadataType

ค่าแจกแจง

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

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

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

MediaFileSystemMetadata

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

  • deviceId

    สตริง ไม่บังคับ

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

  • galleryId

    สตริง

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

  • isAvailable

    บูลีน

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

  • isMediaDevice

    บูลีน

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

  • isRemovable

    บูลีน

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

  • ชื่อ

    สตริง

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

MediaFileSystemsDetails

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

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

    GetMediaFileSystemsInteractivity ไม่บังคับ

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

MediaMetadata

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

  • อัลบั้ม

    สตริง ไม่บังคับ

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

  • ศิลปิน

    สตริง ไม่บังคับ

  • attachedImages

    Blob[]

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

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

    สตริง ไม่บังคับ

  • ลิขสิทธิ์

    สตริง ไม่บังคับ

  • disc

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

  • ระยะเวลา

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

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

  • แนวเพลง

    สตริง ไม่บังคับ

  • ส่วนสูง

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

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

  • ภาษา

    สตริง ไม่บังคับ

  • mimeType

    สตริง

    ประเภท MIME ที่เบราว์เซอร์ดมกลิ่น

  • rawTags

    StreamInfo[]

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

  • การหมุน

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

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

  • title

    สตริง ไม่บังคับ

  • แทร็ก

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

  • ความกว้าง

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

MediaMetadataOptions

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

  • metadataType

    GetMetadataType ไม่บังคับ

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

StreamInfo

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

  • แท็ก

    ออบเจ็กต์

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

  • ประเภท

    สตริง

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

เมธอด

addGalleryWatch()

Promise 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
): Promise<AddGalleryWatchResult>

เพิ่มการดูแกลเลอรีสำหรับแกลเลอรีที่มีรหัสแกลเลอรีที่ระบุ จากนั้นระบบจะเรียกใช้การเรียกกลับที่ระบุพร้อมผลลัพธ์ที่สำเร็จหรือไม่สำเร็จ

พารามิเตอร์

  • galleryId

    สตริง

  • callback

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

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

    (result: AddGalleryWatchResult) => void

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

  • Chrome 116 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      สตริง

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

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

พารามิเตอร์

  • mediaFileSystem

    DOMFileSystem

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

getMediaFileSystems()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

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

พารามิเตอร์

  • รายละเอียด

    MediaFileSystemsDetails ไม่บังคับ

  • callback

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

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

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

  • Promise<DOMFileSystem[]>

    Chrome 116 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getMetadata()

Promise 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
): Promise<MediaMetadata>

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

พารามิเตอร์

  • mediaFile

    Blob

  • ตัวเลือก

    MediaMetadataOptions ไม่บังคับ

  • callback

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

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

    (metadata: MediaMetadata) => void

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

  • Promise<MediaMetadata>

    Chrome 116 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

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

พารามิเตอร์

  • galleryId

    สตริง

กิจกรรม

onGalleryChanged

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: GalleryChangeDetails) => void