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

Soorten

AddGalleryWatchResult

Eigenschappen

  • galerijId

    snaar

  • succes

    Booleaans

GalleryChangeDetails

Eigenschappen

  • galerijId

    snaar

    Identificeert de gewijzigde galerij.

  • Type wijzigingsgebeurtenis.

GalleryChangeType

Enum

"inhoud_gewijzigd"
De inhoud van de galerij is veranderd.

"watch_dropped"
Het horloge is gevallen omdat het apparaat is losgemaakt, de galerietoestemming is ingetrokken of om een ​​andere reden.

GetMediaFileSystemsInteractivity

Enum

"Nee"
Handel niet interactief.

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

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

GetMetadataType

Enum

"alle"
Haal het mime-type, de metagegevenstags en de bijgevoegde afbeeldingen op.

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

"mimeTypeOnly"
Haal alleen het MIME-type op.

MediaFileSystemMetadata

Eigenschappen

  • apparaatId

    tekenreeks optioneel

    Als de mediagalerij zich op een verwisselbaar apparaat bevindt: een unieke ID voor het apparaat terwijl het apparaat online is.

  • galerijId

    snaar

    Een unieke en blijvende ID voor de mediagalerij.

  • isBeschikbaar

    Booleaans

    Waar als het apparaat momenteel beschikbaar is.

  • isMediaDevice

    Booleaans

    Waar als het apparaat waarop de mediagalerij staat, is gedetecteerd als een media-apparaat. dwz er is een PTP- of MTP-apparaat, of er is een DCIM-directory aanwezig.

  • is verwijderbaar

    Booleaans

    Waar als de mediagalerij zich op een verwisselbaar apparaat bevindt.

  • naam

    snaar

    De naam van het bestandssysteem.

MediaFileSystemsDetails

Eigenschappen

  • interactieve

    GetMediaFileSystemsInteractiviteit optioneel

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

MediaMetadata

Eigenschappen

  • album

    tekenreeks optioneel

    Gedefinieerd voor audio en video.

  • artiest

    tekenreeks optioneel

  • bijgevoegde afbeeldingen

    Klontje[]

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

  • opmerking

    tekenreeks optioneel

  • copyright

    tekenreeks optioneel

  • schijf

    nummer optioneel

  • duur

    nummer optioneel

    Gedefinieerd voor audio en video. Binnen enkele seconden.

  • genre

    tekenreeks optioneel

  • hoogte

    nummer optioneel

    Gedefinieerd voor video. Pixels.

  • taal

    tekenreeks optioneel

  • mimeType

    snaar

    De browser heeft het mime-type gesnoven.

  • onbewerkte tags

    StreamInfo []

    Alle metadata in het mediabestand. Voor formaten met meerdere streams blijft de streamvolgorde behouden. Metagegevens van containers zijn het eerste element.

  • rotatie

    nummer optioneel

    Gedefinieerd voor video. In graden.

  • titel

    tekenreeks optioneel

  • spoor

    nummer optioneel

  • breedte

    nummer optioneel

MediaMetadataOptions

Eigenschappen

  • metadataType

    GetMetadataType optioneel

    Specificeert welke subset van de metagegevens moet worden opgehaald. Standaard ingesteld op 'alles' als de optie wordt 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, dwz "mp3", "h264".

Methoden

addGalleryWatch()

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

Voegt een galerijbewaking toe voor de galerij met de opgegeven galerij-ID. De gegeven callback wordt vervolgens afgevuurd met een succes- of mislukkingsresultaat.

Parameters

Retouren

  • Chroom 116+

    Beloften worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • mediaFileSystemen

      DOMFilesysteem[]

    • geselecteerdeBestandSysteemnaam

      snaar

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Haal metagegevens op over een specifiek mediabestandssysteem.

Parameters

  • mediabestandssysteem

    DOMFilesysteem

Retouren

getMediaFileSystems()

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

Zorg ervoor dat de mediagalerijen in deze user-agent zijn geconfigureerd. Als er geen geconfigureerd of beschikbaar is, ontvangt de callback een lege array.

Parameters

  • details

    MediaFileSystemsDetails optioneel

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystemen

      DOMFilesysteem[]

Retouren

  • Beloof<DOMFileSystem[]>

    Chroom 116+

    Beloften worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

getMetadata()

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

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

Parameters

Retouren

  • Beloof < MediaMetadata >

    Chroom 116+

    Beloften worden alleen ondersteund voor Manifest V3 en hoger, andere platforms moeten callbacks gebruiken.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

Parameters

  • galerijId

    snaar

Evenementen

onGalleryChanged

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

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

Parameters