chrome.mediaGalleries

説明

chrome.mediaGalleries API を使用して、ユーザーのローカル ディスクからメディア ファイル（音声、画像、動画）にアクセスします（ユーザーの同意が必要です）。

権限

mediaGalleries

型

AddGalleryWatchResult

プロパティ

  • galleryId

    文字列

  • 成功

    ブール値

GalleryChangeDetails

プロパティ

  • galleryId

    文字列

    変更されたギャラリーを特定します。

  • 変更イベントのタイプ。

GalleryChangeType

列挙型

"contents_changed"
ギャラリーの内容が変更されました。

「watch_dropped」
デバイスが取り外された、ギャラリーの権限が削除されたなどの理由で、スマートウォッチが外されました。

GetMediaFileSystemsInteractivity

列挙型

「no」
インタラクティブな対応は行わないでください。

「はい」
許可されたメディア ギャラリーを管理するようユーザーに依頼します。

「if_needed」
戻り値のセットが空になる場合にのみ、許可されたギャラリーを管理するようユーザーに求めます。

GetMetadataType

列挙型

"all"
MIME タイプ、メタデータタグ、添付画像を取得します。

"mimeTypeAndTags"
MIME タイプとメタデータタグのみを取得します。

「mimeTypeOnly」
MIME タイプのみを取得します。

MediaFileSystemMetadata

プロパティ

  • deviceId

    文字列 省略可

    メディア ギャラリーが取り外し可能なデバイスにある場合、デバイスがオンラインの間のデバイスの一意の ID。

  • galleryId

    文字列

    メディア ギャラリーの一意で永続的な ID。

  • isAvailable

    ブール値

    デバイスが現在利用可能な場合は true。

  • isMediaDevice

    ブール値

    メディア ギャラリーがあるデバイスがメディア デバイスとして検出された場合は true。つまり、PTP または MTP デバイスであるか、DCIM ディレクトリが存在する場合。

  • isRemovable

    ブール値

    メディア ギャラリーがリムーバブル デバイスにある場合は true。

  • name

    文字列

    ファイル システムの名前。

MediaFileSystemsDetails

プロパティ

  • インタラクティブ

    GetMediaFileSystemsInteractivity 省略可

    許可されたセットを返す前に、追加のメディア ギャラリーへのアクセス権限をユーザーに求めるかどうか。デフォルトはサイレントです。値「yes」が渡された場合、またはアプリにメディア ギャラリーへのアクセス権が付与されておらず、値「if_needed」が渡された場合、メディア ギャラリーの設定ダイアログが表示されます。

MediaMetadata

プロパティ

  • アルバム

    文字列 省略可

    音声と動画用に定義されています。

  • アーティスト

    文字列 省略可

  • attachedImages

    Blob[]

    メディア ファイルのメタデータに埋め込まれた画像。これは、アルバム アートや動画のサムネイルに最もよく使用されます。

  • コメント

    文字列 省略可

  • 著作権

    文字列 省略可

  • レコード盤

    number 省略可

  • duration

    number 省略可

    音声と動画用に定義されています。秒単位。

  • ジャンル

    文字列 省略可

  • height

    number 省略可

    動画用に定義されています。ピクセル単位。

  • language

    文字列 省略可

  • mimeType

    文字列

    ブラウザがスニッフィングした MIME タイプ。

  • rawTags

    StreamInfo[]

    メディア ファイル内のすべてのメタデータ。複数のストリームを含む形式の場合、ストリームの順序は保持されます。コンテナ メタデータは最初の要素です。

  • 回転

    number 省略可

    動画用に定義されています。度単位。

  • title

    文字列 省略可

  • トラック

    number 省略可

  • 幅

    number 省略可

MediaMetadataOptions

プロパティ

  • metadataType

    GetMetadataType 省略可

    取得するメタデータのサブセットを指定します。オプションを省略した場合のデフォルトは「all」です。

StreamInfo

プロパティ

  • tags

    オブジェクト

    ストリームのタグのフィルタされていない文字列 -> 文字列のディクショナリ。

  • type

    文字列

    ストリームのコンテナまたはコーデックの形式（「mp3」、「h264」など）を表します。

メソッド

addGalleryWatch()

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

指定されたギャラリー ID のギャラリーのギャラリー ウォッチを追加します。指定されたコールバックは、成功または失敗の結果とともに起動されます。

パラメータ

戻り値

  • Chrome 116 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

ユーザーにディレクトリ ピッカーを表示し、選択したディレクトリをギャラリーとして追加します。ユーザーがピッカーをキャンセルすると、selectedFileSystemName は空になります。ダイアログを表示するには、ユーザー操作が必要です。ユーザー ジェスチャーがない場合、コールバックはユーザーがキャンセルしたかのように実行されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      文字列

getMediaFileSystemMetadata()

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

特定のメディア ファイル システムに関するメタデータを取得します。

パラメータ

  • mediaFileSystem

    DOMFileSystem

戻り値

getMediaFileSystems()

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

このユーザー エージェントで構成されているメディア ギャラリーを取得します。構成されているものがない場合や、利用可能なものがない場合、コールバックは空の配列を受け取ります。

パラメータ

  • 詳細

    MediaFileSystemsDetails 省略可

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

戻り値

  • Promise<DOMFileSystem[]>

    Chrome 116 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getMetadata()

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

メディア ファイルのメディア固有のメタデータを取得します。これは、メディア ギャラリー内のファイルだけでなく、他の DOM ファイル システムでも機能します。

パラメータ

戻り値

  • Promise<MediaMetadata>

    Chrome 116 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

指定されたギャラリー ID のギャラリーのギャラリー ウォッチを削除します。

パラメータ

  • galleryId

    文字列

イベント

onGalleryChanged

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

メディア ギャラリーが変更されたとき、またはギャラリー ウォッチがドロップされたときに呼び出されます。

パラメータ