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