chrome.mediaGalleries

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

    StreamInfo[]

    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

  • theo dõi

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

Cam kết 
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ố

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

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ề

getMediaFileSystems()

Cam kết 
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ê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()

Cam kết 
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ố

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ó 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ố