説明
chrome.mediaGalleries API を使用して、ユーザーのローカル ディスクからメディア ファイル（音声、画像、動画）にアクセスします（ユーザーの同意が必要です）。
権限
mediaGalleries対象
型
AddGalleryWatchResult
プロパティ
-
galleryId
文字列
-
成功
ブール値
GalleryChangeDetails
プロパティ
-
galleryId
文字列
変更されたギャラリーを識別します。
-
type
変更イベントのタイプ。
GalleryChangeType
列挙型
"contents_changed"
ギャラリーのコンテンツが変更されました。
"watch_dropped"
デバイスが取り外された、ギャラリーの権限が削除された、またはその他の理由により、ウォッチがドロップされました。
GetMediaFileSystemsInteractivity
列挙型
"no"
インタラクティブに動作しません。
「はい」
許可されたメディア ギャラリーを管理するようお客様に依頼します。
"if_needed"
返されるセットが空になる場合にのみ、許可されたギャラリーを管理するようユーザーに求めます。
GetMetadataType
列挙型
"all"
MIME タイプ、メタデータタグ、添付画像を取得します。
"mimeTypeAndTags"
MIME タイプとメタデータタグのみを取得します。
"mimeTypeOnly"
MIME タイプのみを取得します。
MediaFileSystemMetadata
プロパティ
-
deviceId
文字列 省略可
メディア ギャラリーがリムーバブル デバイス上にある場合、デバイスがオンラインのときの一意の ID。
-
galleryId
文字列
メディア ギャラリーの一意で永続的な ID。
-
isAvailable
ブール値
デバイスが現在利用可能な場合は true。
-
isMediaDevice
ブール値
メディア ギャラリーが保存されているデバイスがメディア デバイス（PTP デバイス、MTP デバイス、DCIM ディレクトリが存在するデバイスなど）として検出された場合は true。
-
isRemovable
ブール値
メディア ギャラリーがリムーバブル デバイス上にある場合は true。
-
name
文字列
ファイル システムの名前。
MediaFileSystemsDetails
プロパティ
-
インタラクティブ
許可されたセットを返す前に、追加のメディア ギャラリーへのアクセス許可をユーザーに求めるかどうか。デフォルトはサイレントです。値「yes」が渡された場合、またはアプリケーションにメディア ギャラリーへのアクセス権が付与されておらず、値「if_needed」が渡された場合は、メディア ギャラリーの設定ダイアログが表示されます。
MediaMetadata
プロパティ
-
アルバム
文字列 省略可
音声と動画に対して定義されます。
-
アーティスト
文字列 省略可
-
attachedImages
Blob[]
メディア ファイルのメタデータに埋め込まれた画像。これは、アルバムアートや動画のサムネイルによく使用されます。
-
コメント
文字列 省略可
-
著作権
文字列 省略可
-
レコード盤
number 省略可
-
期間
number 省略可
音声と動画に対して定義されます。秒単位。
-
ジャンル
文字列 省略可
-
height
number 省略可
動画に対して定義されます。ピクセル単位。
-
言語
文字列 省略可
-
mimeType
文字列
ブラウザが検出した MIME タイプ。
-
rawTags
メディア ファイル内のすべてのメタデータ。複数のストリームを含む形式の場合、ストリームの順序は保持されます。コンテナ メタデータは最初の要素です。
-
ローテーション
number 省略可
動画に対して定義されます。単位は度です。
-
title
文字列 省略可
-
トラック
number 省略可
-
width
number 省略可
MediaMetadataOptions
プロパティ
-
metadataType
GetMetadataType 省略可
取得するメタデータのサブセットを指定します。このオプションを省略した場合のデフォルトは「all」です。
StreamInfo
プロパティ
-
tags
オブジェクト
ストリームのタグのフィルタされていない文字列->文字列辞書。
-
type
文字列
コンテナの形式またはストリームのコーデック（「mp3」、「h264」など）を記述します。
メソッド
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
): Promise<AddGalleryWatchResult>
指定されたギャラリー ID のギャラリーにギャラリー ウォッチを追加します。その後、指定されたコールバックが成功または失敗の結果とともに呼び出されます。
パラメータ
-
galleryId
文字列
-
callback
function 省略可
callbackパラメータは次のようになります。(result: AddGalleryWatchResult) => void
戻り値
-
Promise<AddGalleryWatchResult>
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
戻り値
-
MediaFileSystemMetadata | undefined
getMediaFileSystems()
chrome.mediaGalleries.getMediaFileSystems(
details?: MediaFileSystemsDetails,
callback?: function,
): Promise<DOMFileSystem[]>
このユーザー エージェントで構成されているメディア ギャラリーを取得します。設定されているものや利用可能なものがない場合、コールバックは空の配列を受け取ります。
パラメータ
-
詳細
-
callback
function 省略可
callbackパラメータは次のようになります。(mediaFileSystems: DOMFileSystem[]) => void
-
mediaFileSystems
DOMFileSystem[]
-
戻り値
-
Promise<DOMFileSystem[]>
Chrome 116 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
getMetadata()
chrome.mediaGalleries.getMetadata(
mediaFile: Blob,
options?: MediaMetadataOptions,
callback?: function,
): Promise<MediaMetadata>
メディア ファイルのメディア固有のメタデータを取得します。これは、メディア ギャラリー内のファイルだけでなく、他の DOM ファイルシステムでも機能します。
パラメータ
-
mediaFile
Blob
-
オプション
-
callback
function 省略可
callbackパラメータは次のようになります。(metadata: MediaMetadata) => void
-
metadata
-
戻り値
-
Promise<MediaMetadata>
Chrome 116 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
removeGalleryWatch()
chrome.mediaGalleries.removeGalleryWatch(
galleryId: string,
): void
指定されたギャラリー ID のギャラリーのギャラリー ウォッチを削除します。
パラメータ
-
galleryId
文字列
イベント
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
メディア ギャラリーが変更されたとき、またはギャラリーの監視がドロップされたときに呼び出されます。
パラメータ
-
callback
関数
callbackパラメータは次のようになります。(details: GalleryChangeDetails) => void