chrome.mediaGalleries

説明

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

権限

mediaGalleries

型

AddGalleryWatchResult

プロパティ

  • galleryId

    文字列

  • success

    boolean

GalleryChangeDetails

プロパティ

  • galleryId

    文字列

    変更されたギャラリーを識別します。

  • タイプ

    GalleryChangeType

    変更イベントのタイプ。

GalleryChangeType

Enum

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

"watch_dropped"
デバイスが接続解除された、ギャラリーの権限が削除された、またはその他の理由により、スマートウォッチがドロップされました。

GetMediaFileSystemsInteractivity

Enum

"no"
インタラクティブに操作しないでください。

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

"if_needed"
戻り値セットが空である場合にのみ、許可されたギャラリーを管理するようユーザーに依頼します。

GetMetadataType

Enum

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

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

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

MediaFileSystemMetadata

プロパティ

  • deviceId

    string（省略可）

    メディア ギャラリーがリムーバブル デバイス上にある場合は、デバイスがオンライン状態のデバイスの一意の ID。

  • galleryId

    文字列

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

  • isAvailable

    boolean

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

  • isMediaDevice

    boolean

    メディア ギャラリーがインストールされているデバイスがメディア デバイスとして検出された場合（PTP デバイス、MTP デバイス、DCIM ディレクトリが存在する場合）は true。

  • isRemovable

    boolean

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

  • name

    文字列

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

MediaFileSystemsDetails

プロパティ

  • interactive

    GetMediaFileSystemsInteractivity 省略可

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

MediaMetadata

プロパティ

  • album

    string（省略可）

    音声と動画に対して定義されます。

  • アーティスト

    string（省略可）

  • attachedImages

    blob[]

    メディア ファイルのメタデータに埋め込まれている画像。多くの場合、アルバムアートや動画のサムネイルに使用されます。

  • コメント

    string（省略可）

  • 著作権

    string（省略可）

  • レコード盤

    number（省略可）

  • 期間

    number（省略可）

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

  • ジャンル

    string（省略可）

  • 身長

    number（省略可）

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

  • language

    string（省略可）

  • mimeType

    文字列

    ブラウザが MIME タイプを盗聴しました。

  • rawTags

    StreamInfo[]

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

  • ローテーション

    number（省略可）

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

  • title

    string（省略可）

  • トラック

    number（省略可）

  • 幅

    number（省略可）

MediaMetadataOptions

プロパティ

  • metadataType

    GetMetadataType 省略可

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

StreamInfo

プロパティ

  • tags

    オブジェクト

    ストリームのタグのフィルタリングされていない string->文字列辞書。

  • タイプ

    文字列

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

Methods

addGalleryWatch()

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

指定されたギャラリー ID のギャラリーのギャラリー ウォッチを追加します。その後、指定したコールバックが、成功または失敗の結果で呼び出されます。

パラメータ

戻り値

  • Chrome 116 以降

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

パラメータ

  • callback

    機能

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

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

    • mediaFileSystems

      DOM ファイルシステム []

    • selectedFileSystemName

      文字列

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

パラメータ

  • mediaFileSystem

    DOMFileSystem

戻り値

getMediaFileSystems()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

パラメータ

  • 詳細

    MediaFileSystemsDetails 省略可

  • callback

    関数（省略可）

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

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      DOM ファイルシステム []

戻り値

  • Promise<DOMFileSystem[]>

    Chrome 116 以降

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

getMetadata()

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

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

パラメータ

戻り値

  • Promise<MediaMetadata>

    Chrome 116 以降

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

パラメータ

  • galleryId

    文字列

イベント

onGalleryChanged

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

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

パラメータ