คำอธิบาย
ใช้ chrome.mediaGalleries
API เพื่อเข้าถึงไฟล์สื่อ (เสียง รูปภาพ วิดีโอ) จากดิสก์ในเครื่องของผู้ใช้ (โดยได้รับความยินยอมจากผู้ใช้)
สิทธิ์
mediaGalleries
ประเภท
AddGalleryWatchResult
พร็อพเพอร์ตี้
-
galleryId
string
-
สำเร็จ
boolean
GalleryChangeDetails
พร็อพเพอร์ตี้
-
galleryId
string
ระบุแกลเลอรีที่แก้ไขแล้ว
-
ประเภท
ประเภทเหตุการณ์การเปลี่ยนแปลง
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
ข้อมูลเมตาทั้งหมดในไฟล์สื่อ สำหรับรูปแบบที่มีสตรีมหลายรายการ ลำดับสตรีมจะยังคงอยู่ ข้อมูลเมตาคอนเทนเนอร์คือองค์ประกอบแรก
-
การหมุน
ตัวเลข ไม่บังคับ
กำหนดไว้สำหรับวิดีโอ เป็นองศา
-
title
string ไม่บังคับ
-
แทร็ก
ตัวเลข ไม่บังคับ
-
ความกว้าง
ตัวเลข ไม่บังคับ
MediaMetadataOptions
พร็อพเพอร์ตี้
-
metadataType
GetMetadataType ไม่บังคับ
ระบุชุดย่อยของข้อมูลเมตาที่จะเรียกดู ค่าเริ่มต้นคือ "ทั้งหมด" หากไม่ได้เลือกตัวเลือกนี้
StreamInfo
พร็อพเพอร์ตี้
-
แท็ก
ออบเจ็กต์
พจนานุกรมสตริง->สตริงที่ไม่กรองของแท็กสำหรับสตรีม
-
ประเภท
string
อธิบายรูปแบบของคอนเทนเนอร์หรือตัวแปลงรหัสของสตรีม เช่น "mp3", "h264"
วิธีการ
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
เพิ่มนาฬิกาแกลเลอรีสำหรับแกลเลอรีด้วยรหัสแกลเลอรีที่ระบุ จากนั้นโค้ดเรียกกลับที่ระบุจะเริ่มทำงานโดยได้ผลลัพธ์สำเร็จหรือล้มเหลว
พารามิเตอร์
-
galleryId
string
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: AddGalleryWatchResult) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
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
-
ข้อมูลเมตา
-
การคืนสินค้า
-
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
-
รายละเอียด
-