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
-
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 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
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
-
Titel
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()
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.
Parameter
-
galleryId
String
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: AddGalleryWatchResult) => void
-
Ergebnis
-
Rückgabe
-
Promise<AddGalleryWatchResult>
Chrome 116 oder höherPromise-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.
Parameter
-
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.
Parameter
-
mediaFileSystem
DOMFileSystem
Rückgabe
-
MediaFileSystemMetadata | Nicht definiert
getMediaFileSystems()
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.
Parameter
-
Details
MediaFileSystemsDetails optional
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(mediaFileSystems: DOMFileSystem[]) => void
-
mediaFileSystems
DOMFileSystem[]
-
Rückgabe
-
Promise<DOMFileSystem[]>
Chrome 116 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getMetadata()
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.
Parameter
-
mediaFile
Blob
-
Optionen
MediaMetadataOptions optional
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(metadata: MediaMetadata) => void
-
Metadaten
-
Rückgabe
-
Promise<MediaMetadata>
Chrome 116 oder höherPromise-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.
Parameter
-
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
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(details: GalleryChangeDetails) => void
-
Details
-