chrome.mediaGalleries

Beschreibung

Mit der chrome.mediaGalleries API können Sie (mit Zustimmung des Nutzers) auf Mediendateien (Audio, Bilder, Videos) auf den lokalen Festplatten des Nutzers zugreifen.

Berechtigungen

mediaGalleries

Verfügbarkeit

Nur ChromeOS

Typen

AddGalleryWatchResult

Attribute

  • galleryId

    String

  • Erfolg

    boolean

GalleryChangeDetails

Attribute

  • galleryId

    String

    Gibt die geänderte Galerie an.

  • Art des Änderungsereignisses.

GalleryChangeType

Enum

"contents_changed"
Der Inhalt der Galerie hat sich geändert.

„watch_dropped“
Die Smartwatch wurde entfernt, weil das Gerät getrennt wurde, die Berechtigung für die Galerie entfernt wurde oder aus einem anderen Grund.

GetMediaFileSystemsInteractivity

Enum

„Nein“
Nicht interaktiv reagieren.

yes
Nutzer bitten, die zulässigen Mediengalerien zu verwalten

„if_needed“
Nutzer auffordern, nur dann erlaubte Galerien zu verwalten, wenn die Rückgabe ansonsten leer wäre.

GetMetadataType

Enum

„all“
MIME-Typ, Metadaten-Tags und angehängte Bilder abrufen.

"mimeTypeAndTags"
Nur den MIME-Typ und die Metadatentags abrufen.

„mimeTypeOnly“
Nur den MIME-Typ abrufen.

MediaFileSystemMetadata

Attribute

  • deviceId

    String optional

    Wenn sich die Media-Galerie auf einem Wechseldatenträger befindet, eine eindeutige ID für das Gerät, während es online ist.

  • galleryId

    String

    Eine eindeutige und dauerhafte ID für die Media-Galerie.

  • isAvailable

    boolean

    „True“, wenn das Gerät derzeit verfügbar ist.

  • isMediaDevice

    boolean

    „True“, wenn das Gerät, auf dem sich die Media-Galerie befindet, als Mediengerät erkannt wurde, d. h. ein PTP- oder MTP-Gerät oder ein DCIM-Verzeichnis vorhanden ist.

  • isRemovable

    boolean

    „True“, wenn sich die Mediengalerie auf einem Wechseldatenträger befindet.

  • name

    String

    Der Name des Dateisystems.

MediaFileSystemsDetails

Attribute

  • interactive

    GetMediaFileSystemsInteractivity optional

    Gibt an, ob der Nutzer vor der Rückgabe des zulässigen Sets um die Berechtigung für zusätzliche Mediengalerien gebeten werden soll. Der Standardwert ist „Stumm“. Wenn der Wert „yes“ übergeben wird oder der Anwendung kein Zugriff auf Mediengalerien gewährt wurde und der Wert „if_needed“ übergeben wird, wird das Konfigurationsdialogfeld für Mediengalerien angezeigt.

MediaMetadata

Attribute

  • album

    String optional

    Für Audio und Video definiert.

  • Künstler

    String optional

  • attachedImages

    Blob[]

    Die in den Metadaten der Mediendatei eingebetteten Bilder. Dies wird am häufigsten für Albumcover oder Videominiaturen verwendet.

  • Kommentar

    String optional

  • Urheberrecht

    String optional

  • disc

    number optional

  • Dauer

    number optional

    Für Audio und Video definiert. In Sekunden.

  • Genre

    String optional

  • Höhe

    number optional

    Für Videos definiert. In Pixeln.

  • Sprache

    String optional

  • mimeType

    String

    Der vom Browser erkannte MIME-Typ.

  • rawTags

    StreamInfo[]

    Alle Metadaten in der Mediendatei. Bei Formaten mit mehreren Streams wird die Streamreihenfolge beibehalten. Containermetadaten sind das erste Element.

  • Rotation

    number optional

    Für Videos definiert. In Grad.

  • Titel

    String optional

  • Laufen

    number optional

  • Breite

    number optional

MediaMetadataOptions

Attribute

  • metadataType

    GetMetadataType optional

    Gibt an, welche Teilmenge der Metadaten abgerufen werden soll. Der Standardwert ist „all“, wenn die Option weggelassen wird.

StreamInfo

Attribute

  • Tags

    Objekt

    Ein ungefiltertes String->String-Dictionary mit Tags für den Stream.

  • Typ

    String

    Beschreibt das Format des Containers oder den Codec des Streams, z.B. „mp3“ oder „h264“.

Methoden

addGalleryWatch()

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

Fügt der Galerie mit der angegebenen Galerie-ID eine Galerie-Beobachtung hinzu. Der angegebene Callback wird dann mit einem Ergebnis für Erfolg oder Fehler ausgelöst.

Parameter

Ausgabe

  • Chrome 116 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

addUserSelectedFolder()

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

Dem Nutzer wird eine Verzeichnisauswahl angezeigt und das ausgewählte Verzeichnis wird als Galerie hinzugefügt. Wenn der Nutzer die Auswahl abbrechen, ist „selectedFileSystemName“ leer. Das Dialogfeld wird nur angezeigt, wenn der Nutzer eine Geste ausführt. Ohne Nutzeraktion wird der Callback so ausgeführt, als hätte der Nutzer die Aktion abgebrochen.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      String

getMediaFileSystemMetadata()

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

Metadaten zu einem bestimmten Media-Dateisystem abrufen.

Parameter

  • mediaFileSystem

    DOMFileSystem

Ausgabe

getMediaFileSystems()

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

Ruft die in diesem User-Agent konfigurierten Mediengalerien ab. Wenn keine konfiguriert oder verfügbar sind, erhält der Callback ein leeres Array.

Parameter

  • Details

    MediaFileSystemsDetails optional

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Ausgabe

  • Promise<DOMFileSystem[]>

    Chrome 116 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getMetadata()

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

Ruft die medienspezifischen Metadaten für eine Mediendatei ab. Das sollte sowohl für Dateien in Mediengalerien als auch für andere DOM-Dateisysteme funktionieren.

Parameter

Ausgabe

  • Promise<MediaMetadata>

    Chrome 116 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

removeGalleryWatch()

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

Entfernt eine Galeriebenachrichtigung für die Galerie mit der angegebenen Galerie-ID.

Parameter

  • galleryId

    String

Ereignisse

onGalleryChanged

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

Wird ausgelöst, wenn sich eine Mediengalerie ändert oder ein Galerie-Watcher entfernt wird.

Parameter