chrome.mediaGalleries

説明

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

権限

mediaGalleries

型

AddGalleryWatchResult

プロパティ

  • galleryId

    文字列

  • success

    ブール値

GalleryChangeDetails

プロパティ

  • galleryId

    文字列

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

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

GalleryChangeType

列挙型

"contents_changed"
ギャラリーのコンテンツが変更されました。

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

GetMediaFileSystemsInteractivity

列挙型

"no"
対話型の操作を行わないでください。

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

"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

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

  • コメント

    文字列（省略可）

  • 著作権

    文字列（省略可）

  • レコード盤

    数値（省略可）

  • duration

    数値（省略可）

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

  • ジャンル

    文字列（省略可）

  • height

    数値（省略可）

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

  • language

    文字列（省略可）

  • mimeType

    文字列

    ブラウザが MIME タイプを検出しました。

  • rawTags

    StreamInfo[]

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

  • 回転

    数値（省略可）

    動画に対して定義されます。度数。

  • title

    文字列（省略可）

  • トラック

    数値（省略可）

  • 幅

    数値（省略可）

MediaMetadataOptions

プロパティ

  • metadataType

    GetMetadataType（省略可）

    取得するメタデータのサブセットを指定します。デフォルトは「all」です。指定します。

StreamInfo

プロパティ

  • tags

    オブジェクト

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

  • type

    文字列

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

メソッド

addGalleryWatch()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

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

パラメータ

戻り値

  • Promise&lt;AddGalleryWatchResult&gt;

    Chrome 116 以降

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

パラメータ

  • callback

    関数

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      文字列

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

パラメータ

  • mediaFileSystem

    DOMFileSystem

戻り値

getMediaFileSystems()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

パラメータ

  • 詳細

    MediaFileSystemsDetails オプション

  • callback

    関数（省略可）

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

戻り値

  • Promise&lt;DOMFileSystem[]&gt;

    Chrome 116 以降

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

getMetadata()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

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

パラメータ

戻り値

  • Promise&lt;MediaMetadata&gt;

    Chrome 116 以降

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

指定されたギャラリー ID のギャラリーのギャラリー監視を削除します。

パラメータ

  • galleryId

    文字列

イベント

onGalleryChanged

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

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

パラメータ