Nội dung mô tả
Dùng API chrome.mediaGalleries
để truy cập vào các tệp nội dung nghe nhìn (âm thanh, hình ảnh, video) từ ổ đĩa cục bộ của người dùng (có sự đồng ý của người dùng).
Quyền
mediaGalleries
Loại
AddGalleryWatchResult
Thuộc tính
-
galleryId
string
-
thành công
boolean
GalleryChangeDetails
Thuộc tính
-
galleryId
string
Xác định thư viện được sửa đổi.
-
loại
Loại sự kiện thay đổi.
GalleryChangeType
Liệt kê
"contents_replace"
Nội dung của thư viện đã thay đổi.
"watch_dropped"
Đồng hồ bị xoá do thiết bị đã bị tháo, quyền của thư viện đã bị xoá hoặc lý do khác.
GetMediaFileSystemsInteractivity
Liệt kê
"no"
Không hành động mang tính tương tác.
"yes"
Yêu cầu người dùng quản lý các thư viện nội dung nghe nhìn được phép.
"if_needed"
Yêu cầu người dùng chỉ quản lý các thư viện được cho phép trong trường hợp tập hợp trả về trống.
GetMetadataType
Liệt kê
"all"
Truy xuất loại MIME, thẻ siêu dữ liệu và hình ảnh đính kèm.
"mimeTypeAndTag"
Chỉ truy xuất loại MIME và thẻ siêu dữ liệu.
"mimeTypeOnly"
Chỉ truy xuất loại MIME.
MediaFileSystemMetadata
Thuộc tính
-
deviceId
chuỗi không bắt buộc
Nếu thư viện nội dung đa phương tiện nằm trên một thiết bị di động, thì một mã nhận dạng duy nhất cho thiết bị đó khi thiết bị đang kết nối mạng.
-
galleryId
string
Mã nhận dạng duy nhất và cố định cho thư viện nội dung nghe nhìn.
-
isAvailable
boolean
Đúng nếu thiết bị hiện có sẵn.
-
isMediaDevice
boolean
Đúng nếu thiết bị đang bật thư viện nội dung đa phương tiện là thiết bị truyền thông, tức là thiết bị PTP hoặc MTP hoặc có thư mục DCIM.
-
isRemovable
boolean
Đúng nếu thư viện nội dung đa phương tiện ở trên một thiết bị có thể tháo rời.
-
tên
string
Tên của hệ thống tệp.
MediaFileSystemsDetails
Thuộc tính
-
có tính tương tác
GetMediaFileSystemsInteractivity không bắt buộc
Liệu có nhắc người dùng cấp quyền truy cập vào các thư viện nội dung nghe nhìn khác hay không trước khi trả về tập hợp được cho phép. Mặc định là im lặng. Nếu giá trị "yes" được chuyển hoặc nếu ứng dụng chưa được cấp quyền truy cập vào bất kỳ thư viện nội dung nghe nhìn nào và giá trị "if_needed" được chuyển thì hộp thoại cấu hình thư viện nội dung đa phương tiện sẽ xuất hiện.
MediaMetadata
Thuộc tính
-
album
chuỗi không bắt buộc
Được xác định cho âm thanh và video.
-
artist
chuỗi không bắt buộc
-
attachedImages
Bùng nổ[]
Hình ảnh được nhúng trong siêu dữ liệu của tệp đa phương tiện. Định dạng này thường được dùng cho ảnh bìa đĩa nhạc hoặc hình thu nhỏ video.
-
bình luận
chuỗi không bắt buộc
-
Bản quyền
chuỗi không bắt buộc
-
đĩa
số không bắt buộc
-
duration
số không bắt buộc
Được xác định cho âm thanh và video. Tính bằng giây.
-
thể loại
chuỗi không bắt buộc
-
độ cao
số không bắt buộc
Được xác định cho video. Tính bằng pixel.
-
language
chuỗi không bắt buộc
-
mimeType
string
Trình duyệt đã phát hiện loại MIME.
-
rawTags
Tất cả siêu dữ liệu trong tệp đa phương tiện. Đối với định dạng có nhiều luồng, thứ tự luồng sẽ được giữ nguyên. Siêu dữ liệu vùng chứa là phần tử đầu tiên.
-
xoay
số không bắt buộc
Được xác định cho video. Theo độ.
-
title
chuỗi không bắt buộc
-
bản nhạc
số không bắt buộc
-
chiều rộng
số không bắt buộc
MediaMetadataOptions
Thuộc tính
-
metadataType
Không bắt buộc GetMetadataType
Chỉ định tập hợp con siêu dữ liệu cần truy xuất. Giá trị mặc định là "all" nếu bạn bỏ qua lựa chọn này.
StreamInfo
Thuộc tính
-
thẻ
đối tượng
Từ điển chuỗi->chuỗi gồm các thẻ chưa được lọc cho luồng.
-
loại
string
Mô tả định dạng vùng chứa hoặc bộ mã hoá và giải mã của luồng, ví dụ: "mp3", "h264".
Phương thức
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
Thêm đồng hồ thư viện cho thư viện với ID thư viện đã chỉ định. Lệnh gọi lại đã cho sau đó được kích hoạt với kết quả thành công hoặc không thành công.
Tham số
-
galleryId
string
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(result: AddGalleryWatchResult) => void
-
kết quả
-
Giá trị trả về
-
Promise<AddGalleryWatchResult>
Chrome 116 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.
addUserSelectedFolder()
chrome.mediaGalleries.addUserSelectedFolder(
callback: function,
)
Trình bày bộ chọn thư mục cho người dùng và thêm thư mục đã chọn làm thư viện. Nếu người dùng huỷ bộ chọn, selectedFileSystemName sẽ trống. Cần có cử chỉ của người dùng để hộp thoại hiển thị. Nếu không có cử chỉ của người dùng, lệnh gọi lại sẽ chạy như thể người dùng đã huỷ.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void
-
mediaFileSystems
Hệ thống tệp DOM[]
-
selectedFileSystemName
string
-
getMediaFileSystemMetadata()
chrome.mediaGalleries.getMediaFileSystemMetadata(
mediaFileSystem: DOMFileSystem,
)
Lấy siêu dữ liệu về một hệ thống tệp nội dung nghe nhìn cụ thể.
Tham số
-
mediaFileSystem
DOMFileSystem
Giá trị trả về
-
MediaFileSystemMetadata | không xác định
getMediaFileSystems()
chrome.mediaGalleries.getMediaFileSystems(
details?: MediaFileSystemsDetails,
callback?: function,
)
Tải thư viện nội dung nghe nhìn đã định cấu hình trong tác nhân người dùng này. Nếu không có sẵn hoặc không định cấu hình, lệnh gọi lại sẽ nhận được một mảng trống.
Tham số
-
chi tiết
MediaFileSystemsDetails không bắt buộc
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(mediaFileSystems: DOMFileSystem[]) => void
-
mediaFileSystems
Hệ thống tệp DOM[]
-
Giá trị trả về
-
Promise<DOMFileSystem[]>
Chrome 116 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.
getMetadata()
chrome.mediaGalleries.getMetadata(
mediaFile: Blob,
options?: MediaMetadataOptions,
callback?: function,
)
Lấy siêu dữ liệu dành riêng cho nội dung nghe nhìn cho một tệp nội dung nghe nhìn. Cách này sẽ áp dụng cho các tệp trong thư viện nội dung đa phương tiện cũng như các hệ thống tệp DOM khác.
Tham số
-
mediaFile
Vệt sáng
-
tùy chọn
MediaMetadataOptions không bắt buộc
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(metadata: MediaMetadata) => void
-
siêu dữ liệu
-
Giá trị trả về
-
Promise<MediaMetadata>
Chrome 116 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.
removeGalleryWatch()
chrome.mediaGalleries.removeGalleryWatch(
galleryId: string,
)
Xoá đồng hồ thư viện cho thư viện có mã thư viện đã chỉ định.
Tham số
-
galleryId
string
Sự kiện
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
Được kích hoạt khi một thư viện nội dung nghe nhìn thay đổi hoặc đồng hồ thư viện bị bỏ qua.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(details: GalleryChangeDetails) => void
-
chi tiết
-