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

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.

Ja
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"
Ruft nur den MIME-Typ und die Metadatentags ab.

"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, solange 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 Mediengalerie befindet, als Mediengerät erkannt wurde, d. h. als PTP- oder MTP-Gerät oder wenn 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 um die Berechtigung für zusätzliche Mediengalerien gebeten werden soll, bevor die zulässige Menge zurückgegeben wird. 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 die 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 Video 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 Video 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. Für die Anzeige des Dialogfelds ist eine Nutzeraktion erforderlich. Ohne Nutzeraktion wird der Callback so ausgeführt, als hätte der Nutzer 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 mediaspezifischen 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 gelöscht wird.

Parameter