chrome.mediaGalleries

คำอธิบาย

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

สิทธิ์

mediaGalleries

ความพร้อมใช้งาน

ChromeOS เท่านั้น

ประเภท

AddGalleryWatchResult

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

  • galleryId

    สตริง

  • สำเร็จ

    บูลีน

GalleryChangeDetails

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

  • galleryId

    สตริง

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

  • ประเภท

    GalleryChangeType

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

GalleryChangeType

ค่าแจกแจง

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

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

GetMediaFileSystemsInteractivity

ค่าแจกแจง

"no"
ไม่ดำเนินการแบบอินเทอร์แอกทีฟ

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

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

GetMetadataType

ค่าแจกแจง

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

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

"mimeTypeOnly"
ดึงข้อมูลเฉพาะประเภท MIME

MediaFileSystemMetadata

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

  • deviceId

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

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

  • galleryId

    สตริง

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

  • isAvailable

    บูลีน

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

  • isMediaDevice

    บูลีน

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

  • isRemovable

    บูลีน

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

  • name

    สตริง

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

MediaFileSystemsDetails

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

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

    GetMediaFileSystemsInteractivity ไม่บังคับ

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

MediaMetadata

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

  • อัลบั้ม

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

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

  • ศิลปิน

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

  • attachedImages

    Blob[]

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

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

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

  • ลิขสิทธิ์

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

  • disc

    number ไม่บังคับ

  • ระยะเวลา

    number ไม่บังคับ

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

  • แนวเพลง

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

  • ความสูง

    number ไม่บังคับ

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

  • ภาษา

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

  • mimeType

    สตริง

    ประเภท MIME ที่เบราว์เซอร์ตรวจพบ

  • rawTags

    StreamInfo[]

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

  • การหมุนเวียน

    number ไม่บังคับ

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

  • title

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

  • แทร็ก

    number ไม่บังคับ

  • ความกว้าง

    number ไม่บังคับ

MediaMetadataOptions

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

  • metadataType

    GetMetadataType ไม่บังคับ

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

StreamInfo

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

  • แท็ก

    ออบเจ็กต์

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

  • ประเภท

    สตริง

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

เมธอด

addGalleryWatch()

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

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

พารามิเตอร์

  • galleryId

    สตริง

  • callback

    function ไม่บังคับ

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

    (result: AddGalleryWatchResult) => void

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

  • Chrome 116 ขึ้นไป

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

addUserSelectedFolder()

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

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

พารามิเตอร์

  • 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 นี้ หากไม่มีการกำหนดค่าหรือไม่มีตัวเลือกที่พร้อมใช้งาน Callback จะได้รับอาร์เรย์ว่าง

พารามิเตอร์

  • รายละเอียด

    MediaFileSystemsDetails ไม่บังคับ

  • callback

    function ไม่บังคับ

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

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

  • Promise<DOMFileSystem[]>

    Chrome 116 ขึ้นไป

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

getMetadata()

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

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

พารามิเตอร์

  • mediaFile

    Blob

  • ตัวเลือก

    MediaMetadataOptions ไม่บังคับ

  • callback

    function ไม่บังคับ

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

    (metadata: MediaMetadata) => void

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

  • Promise<MediaMetadata>

    Chrome 116 ขึ้นไป

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

removeGalleryWatch()

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

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

พารามิเตอร์

  • galleryId

    สตริง

กิจกรรม

onGalleryChanged

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (details: GalleryChangeDetails) => void