chrome.mediaGalleries

Beschrijving

Gebruik de chrome.mediaGalleries API om toegang te krijgen tot mediabestanden (audio, afbeeldingen, video) vanaf de lokale schijven van de gebruiker (met toestemming van de gebruiker).

Machtigingen

mediaGalleries

Typen

AddGalleryWatchResult

Eigenschappen

  • galerij-ID

    snaar

  • succes

    Booleaanse

GalleryChangeDetails

Eigenschappen

  • galerij-ID

    snaar

    Identificeert de gewijzigde galerij.

  • Type wijzigingsgebeurtenis.

GalleryChangeType

Enum

"inhoud_gewijzigd"
De inhoud van de galerij is gewijzigd.

"watch_dropped"
Het horloge is verwijderd omdat het apparaat is losgekoppeld, de galerijmachtiging is ingetrokken of om een andere reden.

GetMediaFileSystemsInteractivity

Enum

"Nee"
Ga niet interactief te werk.

"Ja"
Vraag de gebruiker om de toegestane mediagalerijen te beheren.

"indien nodig"
Vraag de gebruiker om toegestane galerijen alleen te beheren als de retourset anders leeg zou zijn.

GetMetadataType

Enum

"alle"
Haal het MIME-type, metadatatags en bijgevoegde afbeeldingen op.

"mimeTypeEnTags"
Haal alleen het MIME-type en de metadatatags op.

"mimeTypeOnly"
Haal alleen het MIME-type op.

MediaFileSystemMetadata

Eigenschappen

  • apparaat-ID

    string optioneel

    Als de mediagalerij zich op een verwijderbaar apparaat bevindt, een unieke ID voor het apparaat zolang het apparaat online is.

  • galerij-ID

    snaar

    Een unieke en blijvende id voor de mediagalerij.

  • isBeschikbaar

    Booleaanse

    Waar als het apparaat momenteel beschikbaar is.

  • isMediaDevice

    Booleaanse

    Waar als het apparaat waarop de mediagalerij zich bevindt, is gedetecteerd als een media-apparaat, d.w.z. een PTP- of MTP-apparaat, of als er een DCIM-directory aanwezig is.

  • isVerwijderbaar

    Booleaanse

    Waar als de mediagalerij zich op een verwijderbaar apparaat bevindt.

  • naam

    snaar

    De naam van het bestandssysteem.

MediaFileSystemsDetails

Eigenschappen

  • interactieve

    GetMediaFileSystemsInteractivity optioneel

    Of de gebruiker om toestemming voor extra mediagalerijen moet worden gevraagd voordat de toegestane set wordt geretourneerd. Standaard is dit stil. Als de waarde 'yes' wordt doorgegeven, of als de applicatie geen toegang heeft tot mediagalerijen en de waarde 'if_needed' wordt doorgegeven, wordt het configuratievenster voor de mediagalerij weergegeven.

MediaMetadata

Eigenschappen

  • album

    string optioneel

    Gedefinieerd voor audio en video.

  • artiest

    string optioneel

  • bijgevoegde afbeeldingen

    Blob[]

    De afbeeldingen die zijn ingesloten in de metadata van het mediabestand. Dit wordt meestal gebruikt voor albumhoezen of videominiaturen.

  • opmerking

    string optioneel

  • copyright

    string optioneel

  • schijf

    nummer optioneel

  • duur

    nummer optioneel

    Gedefinieerd voor audio en video. In seconden.

  • genre

    string optioneel

  • hoogte

    nummer optioneel

    Gedefinieerd voor video. In pixels.

  • taal

    string optioneel

  • mimeType

    snaar

    De browser heeft het MIME-type gedetecteerd.

  • rawTags

    StreamInfo []

    Alle metadata in het mediabestand. Voor formaten met meerdere streams blijft de streamvolgorde behouden. Containermetadata is het eerste element.

  • rotatie

    nummer optioneel

    Gedefinieerd voor video. In graden.

  • titel

    string optioneel

  • spoor

    nummer optioneel

  • breedte

    nummer optioneel

MediaMetadataOptions

Eigenschappen

  • metadataType

    GetMetadataType optioneel

    Geeft aan welke subset van de metadata moet worden opgehaald. Standaard is dit 'alles' als de optie is weggelaten.

StreamInfo

Eigenschappen

  • labels

    voorwerp

    Een ongefilterd string->string-woordenboek met tags voor de stream.

  • type

    snaar

    Beschrijft het formaat van de container of codec van de stream, bijvoorbeeld "mp3" of "h264".

Methoden

addGalleryWatch()

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

Voegt een galerijwacht toe voor de galerij met de opgegeven galerij-ID. De opgegeven callback wordt vervolgens geactiveerd met een succes- of mislukkingsresultaat.

Parameters

Retourneren

  • Chroom 116+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

Presenteer een directorykiezer aan de gebruiker en voeg de geselecteerde directory toe als galerij. Als de gebruiker de kiezer annuleert, blijft selectedFileSystemName leeg. Een gebruikersgebaar is vereist om het dialoogvenster weer te geven. Zonder gebruikersgebaar wordt de callback uitgevoerd alsof de gebruiker heeft geannuleerd.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • geselecteerdeBestandSysteemNaam

      snaar

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

Haal metagegevens op over een specifiek mediabestandssysteem.

Parameters

  • mediaFileSystem

    DOMFileSystem

Retourneren

getMediaFileSystems()

Belofte
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

Configureer de mediagalerijen in deze user agent. Als er geen geconfigureerd of beschikbaar zijn, ontvangt de callback een lege array.

Parameters

  • details

    MediaFileSystemsDetails optioneel

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Retourneren

  • Belofte<DOMFileSystem[]>

    Chroom 116+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getMetadata()

Belofte
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
): Promise<MediaMetadata>

Haalt de mediaspecifieke metadata van een mediabestand op. Dit zou moeten werken voor bestanden in mediagalerijen en andere DOM-bestandssystemen.

Parameters

Retourneren

  • Belofte< MediaMetadata >

    Chroom 116+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

Verwijdert een galerijwacht voor de galerij met de opgegeven galerij-ID.

Parameters

  • galerij-ID

    snaar

Evenementen

onGalleryChanged

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

Wordt geactiveerd wanneer een mediagalerij wordt gewijzigd of een galerijweergave wordt verwijderd.

Parameters