chrome.mediaGalleries

Mô tả

Sử 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) trên ổ đĩa cục bộ của người dùng (khi có sự đồng ý của người dùng).

Quyền

mediaGalleries

Phạm vi cung cấp

Chỉ dành cho ChromeOS

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 đã 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ị rơi do thiết bị bị tháo rời, quyền truy cập vào thư viện đã bị xoá hoặc bất kỳ lý do nào khác.

GetMediaFileSystemsInteractivity

Enum

"no"
Không hoạt động 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 cho phép.

"if_needed"
Yêu cầu người dùng quản lý các thư viện được cho phép chỉ khi tập hợp trả về 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ị tháo rời, thì mã nhận dạng duy nhất cho thiết bị đó khi thiết bị đó kết nối mạng.

  • galleryId

    chuỗi

    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ị có thư viện nội dung nghe nhìn được phát hiệ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 nghe nhìn nằm trên một thiết bị lưu trữ di động.

  • 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 truy cập vào các thư viện nội dung nghe nhìn khác trước khi trả về nhóm nội dung đượ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 nội dung nghe nhìn nào và giá trị "if_needed" được truyền, thì hộp thoại cấu hình thư viện nội dung nghe nhì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. Thường 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

    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. Chỉ trong vài giây.

  • thể loại

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

  • chiều 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 vòng

    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 tuỳ chọn này.

StreamInfo

Thuộc tính

  • thẻ

    đối tượng

    Một từ điển chuỗi->chuỗi chưa 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 bộ mã hoá và giải mã của luồng, 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

    Lờ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,
): void

Hiển thị 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ỷ.

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 nội dung nghe nhì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 thư viện nội dung nghe nhìn được định cấu hình trong tác nhân người dùng này. Nếu không có tài khoản nào được định cấu hình hoặc có sẵn, thì 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ề

  • <DOMFileSystem[]> hứa hẹn

    Chrome 116 trở lên

    Lờ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()

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 áp dụng được cho các tệp trong thư viện nội dung nghe nhì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

    Lờ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,
): void

Xoá một trình xem thư viện cho thư viện có mã thư viện được chỉ định.

Thông số

  • galleryId

    chuỗi

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 một chế độ xem thư viện bị loại bỏ.

Thông số