chrome.mediaGalleries

Beschrijving

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

Rechten

mediaGalleries

Beschikbaarheid

Alleen ChromeOS

Typen

AddGalleryWatchResult

Eigenschappen

  • galleryId

    tekenreeks

  • geslaagd

    booleaans

GalleryChangeDetails

Eigenschappen

  • galleryId

    tekenreeks

    Identificeert de aangepaste galerij.

  • Type wijzigingsgebeurtenis.

GalleryChangeType

Enum

"contents_changed"
De content van de galerij is gewijzigd.

"watch_dropped"
De watch is verwijderd omdat het apparaat is losgekoppeld, de galerijrechten zijn verwijderd of om een andere reden.

GetMediaFileSystemsInteractivity

Enum

"no"
Niet interactief handelen.

yes
De gebruiker vragen om toegestane mediagalerijen te beheren.

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

GetMetadataType

Enum

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

"mimeTypeAndTags"
Alleen het MIME-type en de metadatatags ophalen.

"mimeTypeOnly"
Alleen het MIME-type ophalen.

MediaFileSystemMetadata

Eigenschappen

  • deviceId

    tekenreeks optioneel

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

  • galleryId

    tekenreeks

    Een unieke en permanente ID voor de mediagalerij.

  • isAvailable

    booleaans

    Waar als het apparaat op dit moment beschikbaar is.

  • isMediaDevice

    booleaans

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

  • isRemovable

    booleaans

    Waar als de mediagalerij zich op een verwisselbaar apparaat bevindt.

  • name

    tekenreeks

    De naam van het bestandssysteem.

MediaFileSystemsDetails

Eigenschappen

  • interactief

    GetMediaFileSystemsInteractivity optioneel

    Of de gebruiker om toestemming voor aanvullende mediagalerijen moet worden gevraagd voordat de toegestane set wordt geretourneerd. De standaardinstelling is Stil. Als de waarde 'yes' wordt doorgegeven of als de app geen toegang heeft tot mediagalerijen en de waarde 'if_needed' wordt doorgegeven, wordt het configuratiedialoogvenster voor mediagalerijen getoond.

MediaMetadata

Eigenschappen

  • album

    tekenreeks optioneel

    Gedefinieerd voor audio en video.

  • artiest

    tekenreeks optioneel

  • attachedImages

    Blob[]

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

  • reactie

    tekenreeks optioneel

  • auteursrecht

    tekenreeks optioneel

  • disc

    number optioneel

  • duur

    number optioneel

    Gedefinieerd voor audio en video. In seconden.

  • genre

    tekenreeks optioneel

  • hoogte

    number optioneel

    Gedefinieerd voor video. In pixels.

  • taal

    tekenreeks optioneel

  • mimeType

    tekenreeks

    Het door de browser gedetecteerde MIME-type.

  • rawTags

    StreamInfo[]

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

  • rotatie

    number optioneel

    Gedefinieerd voor video. In graden.

  • titel

    tekenreeks optioneel

  • track

    number optioneel

  • breedte

    number optioneel

MediaMetadataOptions

Eigenschappen

  • metadataType

    GetMetadataType optioneel

    Hiermee wordt aangegeven welke subset van de metadata moet worden opgehaald. De standaardwaarde is 'all' als de optie wordt weggelaten.

StreamInfo

Eigenschappen

  • tags

    object

    Een ongefilterde tekenreeks->tekenreekswoordenboek met tags voor de stream.

  • type

    tekenreeks

    Beschrijft de indeling van de container of codec van de stream, bijvoorbeeld 'mp3', 'h264'.

Methoden

addGalleryWatch()

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

Voegt een galerijcontrole toe voor de galerij met de opgegeven galerij-ID. De opgegeven callback wordt dan geactiveerd met een resultaat voor succes of mislukking.

Parameters

Retourzendingen

  • Chrome 116 of hoger

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

addUserSelectedFolder()

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

Toon een directorykiezer aan de gebruiker en voeg de geselecteerde directory toe als galerij. Als de gebruiker de kiezer annuleert, is selectedFileSystemName leeg. Er is een gebruikersactivatie vereist om het dialoogvenster te tonen. Zonder gebruikersactivatie wordt de callback uitgevoerd alsof de gebruiker heeft geannuleerd.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      tekenreeks

getMediaFileSystemMetadata()

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

Metadata over een specifiek mediabestandssysteem ophalen.

Parameters

  • mediaFileSystem

    DOMFileSystem

Retourzendingen

getMediaFileSystems()

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

Haal de mediagalerijen op die zijn ingesteld in deze user-agent. Als er geen zijn ingesteld of beschikbaar zijn, krijgt de callback een lege array.

Parameters

  • details

    MediaFileSystemsDetails optioneel

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Retourzendingen

  • Promise<DOMFileSystem[]>

    Chrome 116 of hoger

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

getMetadata()

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

Haalt de mediaspecifieke metadata voor een mediabestand op. Dit werkt voor bestanden in mediagalerijen en andere DOM-bestandssystemen.

Parameters

Retourzendingen

  • Promise<MediaMetadata>

    Chrome 116 of hoger

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

removeGalleryWatch()

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

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

Parameters

  • galleryId

    tekenreeks

Evenementen

onGalleryChanged

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

Wordt geactiveerd als een mediagalerij wordt gewijzigd of een galerijcontrole wordt verwijderd.

Parameters