chrome.mediaGalleries

Beschreibung

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

Berechtigungen

mediaGalleries

Typen

AddGalleryWatchResult

Attribute

  • galleryId

    String

  • Erfolgreich

    boolean

GalleryChangeDetails

Attribute

  • galleryId

    String

    Kennzeichnet die geänderte Galerie.

  • Art des Änderungsereignisses

GalleryChangeType

Enum

"contents_changed"
Der Inhalt der Galerie wurde geändert.

"watch_dropped"
Die Smartwatch wurde fallen lassen, weil das Gerät getrennt wurde, die Berechtigung für die Galerie entfernt wurde oder ein anderer Grund dafür vorliegt.

GetMediaFileSystemsInteractivity

Enum

"no"
Handeln Sie nicht interaktiv.

"yes"
Bitte den Nutzer, zulässige Mediengalerien zu verwalten.

"if_needed"
Bitte den Nutzer, nur dann zulässige Galerien zu verwalten, wenn das Rückgabeset ansonsten leer wäre.

GetMetadataType

Enum

"all"
Mime-Typ, Metadaten-Tags und angehängte Bilder abrufen

"mimeTypeAndTags"
Ruft nur den MIME-Typ und die Metadaten-Tags ab.

"mimeTypeOnly"
Nur den MIME-Typ abrufen

MediaFileSystemMetadata

Attribute

  • deviceId

    String optional

    Eine eindeutige ID für das Gerät, wenn es online ist, wenn die Mediengalerie auf einem Wechselgerät gespeichert ist.

  • galleryId

    String

    Eine eindeutige und dauerhafte ID für die Mediagalerie.

  • isAvailable

    boolean

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

  • isMediaDevice

    boolean

    Dieser Wert ist „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

    Dieser Wert ist „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 zur Berechtigung für zusätzliche Mediengalerien aufgefordert werden soll, bevor der zulässige Satz zurückgegeben wird. Die Standardeinstellung ist „Lautlos“. 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 Dialogfeld für die Mediagalerie-Konfiguration angezeigt.

MediaMetadata

Attribute

  • album

    String optional

    Für Audio und Video definiert.

  • artist

    String optional

  • attachedImages

    Blob[]

    Die Bilder, die in die Metadaten der Mediendatei eingebettet sind. Dies wird meistens für Albumcover oder Video-Thumbnails verwendet.

  • Kommentar

    String optional

  • Urheberrecht

    String optional

  • disc

    Nummer optional

  • Dauer

    Nummer optional

    Für Audio und Video definiert. In Sekunden.

  • Genre

    String optional

  • Höhe

    Nummer optional

    Für Videos definiert. In Pixeln.

  • language

    String optional

  • mimeType

    String

    Der Browser hat den MIME-Typ erkannt.

  • rawTags

    StreamInfo[]

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

  • Drehung

    Nummer optional

    Für Videos definiert. In Grad

  • Titel

    String optional

  • Streifen

    Nummer optional

  • Breite

    Nummer optional

MediaMetadataOptions

Attribute

  • metadataType

    GetMetadataType optional

    Gibt an, welche Teilmenge der Metadaten abgerufen werden soll. Wenn die Option weggelassen wird, wird standardmäßig „all“ verwendet.

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" oder "h264".

Methoden

addGalleryWatch()

Versprechen 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

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

Parameters

Rückgaben

  • Chrome 116 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Dem Nutzer eine Verzeichnisauswahl präsentieren und das ausgewählte Verzeichnis als Galerie hinzufügen Wenn der Nutzer die Auswahl abbricht, ist „selectFileSystemName“ leer. Zum Anzeigen des Dialogfelds ist eine Nutzergeste erforderlich. Ohne eine Nutzergeste wird der Callback so ausgeführt, als hätte der Nutzer den Vorgang abgebrochen.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      String

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Metadaten zu einem bestimmten Mediendateisystem abrufen.

Parameters

  • mediaFileSystem

    DOMFileSystem

Rückgaben

getMediaFileSystems()

Versprechen 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

Parameters

  • Details

    MediaFileSystemsDetails optional

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      DOMFileSystem[]

Rückgaben

  • Promise<DOMFileSystem[]>

    Chrome 116 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getMetadata()

Versprechen 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

Ruft die medienspezifischen Metadaten für eine Mediendatei ab. Dies sollte für Dateien in Mediengalerien und anderen DOM-Dateisystemen funktionieren.

Parameters

Rückgaben

  • Promise<MediaMetadata>

    Chrome 116 oder höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

Parameters

  • galleryId

    String

Veranstaltungen

onGalleryChanged

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

Wird ausgelöst, wenn eine Mediengalerie geändert oder eine Galerieuhr auf das Display gelegt wird

Parameters