chrome.mediaGalleries

Mô tả

Sử dụng API chrome.mediaGalleries để truy cập vào các tệp đa phương tiện (âm thanh, hình ảnh, video) trên ổ đĩa cục bộ của người dùng (với sự đồng ý của người dùng).

Quyền

mediaGalleries

Loại

AddGalleryWatchResult

Thuộc tính

  • galleryId

    chuỗi

  • thành công

    boolean

GalleryChangeDetails

Thuộc tính

  • galleryId

    chuỗi

    Xác định thư viện đã được sửa đổi.

  • Loại sự kiện thay đổi.

GalleryChangeType

Enum

"contents_changed"
Nội dung của thư viện đã thay đổi.

"watch_dropped"
Đồng hồ đã bị ngắt kết nối vì thiết bị đã bị tháo rời, quyền truy cập vào thư viện đã bị xoá hoặc vì bất kỳ lý do nào khác.

GetMediaFileSystemsInteractivity

Enum

"không"
Không tương tác.

"yes"
Yêu cầu người dùng quản lý các thư viện đa phương tiện được phép.

"if_needed"
Yêu cầu người dùng quản lý các thư viện được phép chỉ khi tập hợp trả về sẽ trống.

GetMetadataType

Enum

"all"
Truy xuất loại MIME, thẻ siêu dữ liệu và hình ảnh đính kèm.

"mimeTypeAndTags"
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 nghe nhìn nằm trên một thiết bị di động, thì đó là 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

    chuỗi

    Mã nhận dạng duy nhất và cố định cho thư viện đa phương tiện.

  • isAvailable

    boolean

    Đúng nếu thiết bị hiện đang có sẵn.

  • isMediaDevice

    boolean

    True nếu thiết bị có thư viện nội dung nghe nhìn được phát hiện là một thiết bị nghe nhìn, tức là thiết bị PTP hoặc MTP, hoặc có thư mục DCIM.

  • isRemovable

    boolean

    True nếu thư viện nội dung nghe nhìn nằm trên một thiết bị tháo rời được.

  • tên

    chuỗi

    Tên của hệ thống tệp.

MediaFileSystemsDetails

Thuộc tính

  • tương tác

    GetMediaFileSystemsInteractivity không bắt buộc

    Có nhắc người dùng cấp quyền cho các thư viện đa phương tiện khác trước khi trả về bộ được phép hay không. Mặc định là im lặng. Nếu giá trị "yes" được truyề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 đa phương tiện nào và giá trị "if_needed" được truyền, thì hộp thoại cấu hình thư viện đ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

    Blob[]

    Hình ảnh được nhúng trong siêu dữ liệu của tệp nội dung nghe nhìn. Đây là kích thước thường dùng nhất cho ảnh bìa album hoặc hình thu nhỏ của 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

    number không bắt buộc

  • thời lượng

    number 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

    number 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

    chuỗi

    Loại mime mà trình duyệt phát hiện được.

  • rawTags

    StreamInfo[]

    Tất cả siêu dữ liệu trong tệp nội dung nghe nhìn. Đối với các đị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

    number không bắt buộc

    Được xác định cho video. Tính bằng độ.

  • tiêu đề

    chuỗi không bắt buộc

  • bản nhạc

    number không bắt buộc

  • chiều rộng

    number không bắt buộc

MediaMetadataOptions

Thuộc tính

  • metadataType

    GetMetadataType không bắt buộc

    Chỉ định tập hợp con siêu dữ liệu cần truy xuất. 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

    Một từ điển chuỗi->chuỗi chưa được lọc gồm các thẻ cho luồng.

  • loại

    chuỗi

    Mô tả định dạng của vùng chứa hoặc codec của luồng phát, tức là "mp3", "h264".

Phương thức

addGalleryWatch()

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

Thêm một trình theo dõi thư viện cho thư viện có mã thư viện được chỉ định. Sau đó, lệnh gọi lại đã cho sẽ được kích hoạt với kết quả thành công hoặc không thành công.

Thông số

Giá trị trả về

  • Chrome 116 trở lên

    Các promise 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,
): void

Đưa ra một trình 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 xuất hiện. 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ỷ.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      chuỗi

getMediaFileSystemMetadata()

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

Lấy siêu dữ liệu về một hệ thống tệp đa phương tiện cụ thể.

Thông số

  • mediaFileSystem

    DOMFileSystem

Giá trị trả về

getMediaFileSystems()

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

Lấy các thư viện đa phương tiện được định cấu hình trong tác nhân người dùng này. Nếu không có thẻ nào được định cấu hình hoặc có sẵn, lệnh gọi lại sẽ nhận được một mảng trống.

Thông số

  • chi tiết

    MediaFileSystemsDetails không bắt buộc

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Giá trị trả về

  • Promise<DOMFileSystem[]>

    Chrome 116 trở lên

    Các promise 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()

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

Lấy siêu dữ liệu dành riêng cho nội dung nghe nhìn của một tệp nội dung nghe nhìn. Cách này cũng sẽ hoạt động đối với các tệp trong thư viện đa phương tiện cũng như các hệ thống tệp DOM khác.

Thông số

Giá trị trả về

  • Promise<MediaMetadata>

    Chrome 116 trở lên

    Các promise 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,
): void

Xoá một đồng hồ trong thư viện cho thư viện có mã thư viện đã chỉ định.

Thông số

  • galleryId

    chuỗi

Sự kiện

onGalleryChanged

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

Kích hoạt khi một thư viện nội dung nghe nhìn thay đổi hoặc một lệnh theo dõi thư viện bị huỷ.

Thông số