chrome.mediaGalleries

Beschreibung

Verwenden Sie die chrome.mediaGalleries API, um auf Mediendateien (Audio, Bilder, Video) auf den lokalen Laufwerken des Nutzers zuzugreifen (mit Zustimmung des Nutzers).

Berechtigungen

mediaGalleries

Verfügbarkeit

Nur ChromeOS

Typen

AddGalleryWatchResult

Attribute

  • galleryId

    String

  • Erfolg

    boolean

GalleryChangeDetails

Attribute

  • galleryId

    String

    Kennzeichnet die geänderte Galerie.

  • Art des Änderungsereignisses.

GalleryChangeType

Enum

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

"watch_dropped"
Die Überwachung wurde abgebrochen, weil das Gerät getrennt wurde, die Berechtigung für die Galerie entfernt wurde oder aus einem anderen Grund.

GetMediaFileSystemsInteractivity

Enum

"no"
Nicht interaktiv agieren.

„Ja“
Nutzer auffordern, die zulässigen Mediengalerien zu verwalten.

"if_needed"
Der Nutzer wird nur dann aufgefordert, die zulässigen Galerien zu verwalten, wenn die Rückgabemenge andernfalls leer wäre.

GetMetadataType

Enum

"all"
Ruft den MIME-Typ, die Metadaten-Tags und die angehängten Bilder ab.

"mimeTypeAndTags"
Nur den MIME-Typ und die Metadaten-Tags abrufen.

"mimeTypeOnly"
Nur den MIME-Typ abrufen.

MediaFileSystemMetadata

Attribute

  • deviceId

    String optional

    Wenn sich die Mediengalerie auf einem Wechselmedium befindet, eine eindeutige ID für das Gerät, während es online ist.

  • galleryId

    String

    Eine eindeutige und dauerhafte ID für die Mediengalerie.

  • 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. ein PTP- oder MTP-Gerät oder ein DCIM-Verzeichnis vorhanden ist.

  • isRemovable

    boolean

    „True“, wenn sich die Mediengalerie auf einem Wechselmedium befindet.

  • name

    String

    Der Name des Dateisystems.

MediaFileSystemsDetails

Attribute

  • interaktiv

    GetMediaFileSystemsInteractivity optional

    Ob der Nutzer um Erlaubnis für zusätzliche Mediengalerien gebeten werden soll, bevor die zulässige Gruppe zurückgegeben wird. Der Standardwert ist „Lautlos“. Wenn der Wert „yes“ übergeben wird oder wenn die Anwendung keinen Zugriff auf Mediengalerien hat und der Wert „if_needed“ übergeben wird, wird das Dialogfeld für die Konfiguration der Mediengalerie angezeigt.

MediaMetadata

Attribute

  • album

    String optional

    Definiert für Audio und Video.

  • Künstler

    String optional

  • attachedImages

    Blob[]

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

  • Kommentar

    String optional

  • Urheberrecht

    String optional

  • disc

    number optional

  • Dauer

    number optional

    Definiert für Audio und Video. In Sekunden.

  • Genre

    String optional

  • Höhe

    number optional

    Für Videos definiert. In Pixeln.

  • Sprache

    String optional

  • mimeType

    String

    Der vom Browser ermittelte MIME-Typ.

  • rawTags

    StreamInfo[]

    Alle Metadaten in der Mediendatei. Bei Formaten mit mehreren Streams wird die Streamreihenfolge beibehalten. Das erste Element sind die Container-Metadaten.

  • 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. Wenn die Option weggelassen wird, ist der Standardwert „all“.

StreamInfo

Attribute

  • Tags

    Objekt

    Ein ungefiltertes String->String-Wörterbuch mit Tags für den Stream.

  • Typ

    String

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

Methoden

addGalleryWatch()

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

Fügt eine Galeriebeobachtung für die Galerie mit der angegebenen Galerie-ID hinzu. Der angegebene Callback wird dann mit einem Erfolgs- oder Fehlerergebnis ausgelöst.

Parameter

Ausgabe

  • Chrome 116 oder 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 eine Verzeichnisauswahl anzeigen und das ausgewählte Verzeichnis als Galerie hinzufügen. Wenn der Nutzer die Auswahl abbricht, ist „selectedFileSystemName“ leer. Damit das Dialogfeld angezeigt wird, ist eine Nutzergeste erforderlich. Ohne Nutzergeste 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 Mediendateisystem 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

    function optional

    Der Parameter callback sieht so aus: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Ausgabe

  • Promise<DOMFileSystem[]>

    Chrome 116 oder 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 für Dateien in Mediengalerien sowie für andere DOM-Dateisysteme funktionieren.

Parameter

Ausgabe

  • Promise<MediaMetadata>

    Chrome 116 oder 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 Galeriebeobachtung für die Galerie mit der angegebenen Galerie-ID.

Parameter

  • galleryId

    String

Ereignisse

onGalleryChanged

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

Wird ausgelöst, wenn eine Mediengalerie geändert oder eine Galeriebeobachtung gelöscht wird.

Parameter