chrome.mediaGalleries

Mô tả

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) từ ổ đĩa cục bộ của người dùng (khi 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 đã 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ị loại bỏ do thiết bị đã bị tách khỏi thiết bị, quyền thư viện đã bị xoá hoặc bất kỳ lý do nào khác.

GetMediaFileSystemsInteractivity

Enum

"no"
Không được hành động theo cách 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"
Chỉ yêu cầu người dùng quản lý các thư viện được phép trong trường hợp tập dữ liệu trả lại bị trống.

GetMetadataType

Enum

"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à các 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 ở trên một thiết bị có thể tháo rời, thì đó là một mã nhận dạng duy nhất cho thiết bị đó khi thiết bị có kết nối mạng.

  • galleryId

    string

    Mã nhận dạng duy nhất và cố định cho bộ sưu tập nội dung nghe nhìn.

  • Có sẵn

    boolean

    Đúng nếu thiết bị hiện có hoạt động.

  • isMediaDevice

    boolean

    Đúng nếu thiết bị đang bật thư viện nội dung nghe nhìn được phát hiện là thiết bị đa phương tiện. tức là có thiết bị PTP hay MTP hoặc thư mục DCIM.

  • isRemovable

    boolean

    Đúng nếu thư viện nội dung nghe nhìn nằm trên 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

  • 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 bổ sung trước khi trả lại tập hợp được phép hay không. Chế độ mặc định là im lặng. Nếu giá trị là "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 đa phương tiện nào và có 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ẽ hiển thị.

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 đa phương tiện. Biểu tượng này thường được sử 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

  • thời lượng

    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

    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

    số không bắt buộc

    Được xác định cho video. Theo độ.

  • tiêu đề

    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

    GetMetadataType không bắt buộc

    Chỉ định tập hợp con siêu dữ liệu cần truy xuất. Giá trị mặc định là "tất cả" nếu lựa chọn này bị bỏ qua.

StreamInfo

Thuộc tính

  • thẻ

    đối tượng

    Từ điển string->chuỗi chưa lọc của thẻ cho luồng.

  • loại

    string

    Mô tả định dạng của 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()

Lời hứa 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Thêm đồng hồ thư viện cho thư viện có mã nhận dạng thư viện được chỉ định. Sau đó, lệnh gọi lại nhất định được kích hoạt với kết quả thành công hoặc không thành công.

Tham số

Giá trị trả về

  • Promise<AddGalleryWatchResult>

    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,
)

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, thì selectedFileSystemName sẽ trống. Bạn cần thực hiện cử chỉ của người dùng để hộp thoại hiện ra. 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

      DOMFileSystem[]

    • selectedFileSystemName

      string

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

Tham số

  • mediaFileSystem

    DOMFileSystem

Giá trị trả về

getMediaFileSystems()

Lời hứa 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

Định cấu hình các thư viện nội dung nghe nhìn trong tác nhân người dùng này. Nếu không có mã nào được định cấu hình hoặc sử dụng được, thì lệnh gọi lại sẽ nhận 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

      DOMFileSystem[]

Giá trị trả về

  • Promise<DOMFileSystem[]>

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

Lời hứa 
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. Điều này sẽ có tác dụng với 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.

Tham 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,
)

Xoá đồng hồ thư viện cho thư viện có ID thư viện được 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 bị thay đổi hoặc một đồng hồ thư viện bị bỏ qua.

Tham số