chrome.mediaGalleries

Beschreibung

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

Berechtigungen

mediaGalleries

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 wurde geändert.

"watch_dropped"
Die Smartwatch wurde fallen gelassen, weil das Gerät getrennt oder die Galerieberechtigung entfernt wurde oder aus einem anderen Grund.

GetMediaFileSystemsInteractivity

Enum

"no"
Nicht interaktiv handeln

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

"if_needed"
Bitten Sie den Nutzer, nur dann zulässige Galerien zu verwalten, wenn die Rückgabeeinstellung sonst leer wäre.

GetMetadataType

Enum

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

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

"mimeTypeOnly"
Nur den MIME-Typ abrufen.

MediaFileSystemMetadata

Attribute

  • deviceId

    String optional

    Wenn sich die Mediagalerie auf einem Wechselgerät befindet, eine eindeutige ID für das Gerät, während es online 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

    „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 ist vorhanden.

  • isRemovable

    boolean

    „True“, wenn sich die Mediagalerie auf einem Wechselgerät befindet.

  • Name

    String

    Der Name des Dateisystems.

MediaFileSystemsDetails

Attribute

  • interactive

    GetMediaFileSystemsInteractivity optional

    Gibt an, ob der Nutzer nach der Berechtigung für weitere Mediengalerien gefragt wird, bevor der zulässige Satz zurückgegeben wird. Die Standardeinstellung ist „Lautlos“. Wenn der Wert „yes“ übergeben wird oder wenn der Anwendung kein Zugriff auf Mediengalerien gewährt wurde und der Wert 'if_needed' übergeben wurde, wird das Konfigurationsdialogfeld für die Mediagalerie 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. Diese Option wird meistens für Albumcover oder Video-Thumbnails verwendet.

  • Kommentar

    String optional

  • Urheberrecht

    String optional

  • disc

    Zahl optional

  • Dauer

    Zahl optional

    Für Audio und Video definiert. In Sekunden.

  • Genre

    String optional

  • Höhe

    Zahl optional

    Für Videos definiert. In Pixeln.

  • Sprache

    String optional

  • mimeType

    String

    Der MIME-Typ des Browsers wurde erkannt.

  • rawTags

    StreamInfo[]

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

  • Rotation

    Zahl optional

    Für Videos definiert. In Grad.

  • Titel

    String optional

  • Laufen

    Zahl optional

  • Breite

    Zahl optional

MediaMetadataOptions

Attribute

  • metadataType

    GetMetadataType optional

    Gibt an, welche Teilmenge der Metadaten abgerufen werden soll. Die Standardeinstellung ist „alle“. wenn die Option weggelassen wird.

StreamInfo

Attribute

  • Tags

    Objekt

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

  • Typ

    String

    Beschreibt das Format des Containers oder Codec des Streams, z.B. "mp3" oder "h264".

Methoden

addGalleryWatch()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

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

Parameter

Gibt Folgendes zurück:

  • Promise&lt;AddGalleryWatchResult&gt;

    Chrome 116 und höher

    Promise-Objekte 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,
)

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      String

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Metadaten zu einem bestimmten Mediendateisystem abrufen.

Parameter

  • mediaFileSystem

    DOMFileSystem

Gibt Folgendes zurück:

getMediaFileSystems()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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: <ph type="x-smartling-placeholder"></ph>

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Gibt Folgendes zurück:

  • Promise&lt;DOMFileSystem[]&gt;

    Chrome 116 und höher

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

getMetadata()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

Hiermit werden die medienspezifischen Metadaten für eine Mediendatei abgerufen. Dies sollte bei Dateien in Mediengalerien und anderen DOM-Dateisystemen funktionieren.

Parameter

Gibt Folgendes zurück:

  • Promise&lt;MediaMetadata&gt;

    Chrome 116 und höher

    Promise-Objekte 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,
)

Entfernt eine Galerie-Uhr 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 Mediagalerie geändert oder eine Galerie Watch abgelegt wird.

Parameter