chrome.mediaGalleries

Açıklama

Kullanıcının yerel disklerindeki medya dosyalarına (ses, resim, video) erişmek için (kullanıcının izniyle) chrome.mediaGalleries API'sini kullanın.

İzinler

mediaGalleries

Türler

AddGalleryWatchResult

Özellikler

  • galleryId

    dize

  • başarılı

    boolean

GalleryChangeDetails

Özellikler

  • galleryId

    dize

    Değiştirilen galeriyi tanımlar.

  • Değişiklik etkinliğinin türü.

GalleryChangeType

Enum

"contents_changed"
Galerinin içeriği değişti.

"watch_dropped"
Cihazın ayrılması, galeri izninin kaldırılması veya başka bir nedenden dolayı kol saati düşürülmüş.

GetMediaFileSystemsInteractivity

Enum

"hayır"
Etkileşimli davranma.

"yes"
Kullanıcıdan izin verilen medya galerilerini yönetmesini iste.

"if_needed"
Döndürülen küme aksi takdirde boş olacaksa kullanıcıdan yalnızca izin verilen galerileri yönetmesini isteyin.

GetMetadataType

Enum

"all"
MIME türünü, meta veri etiketlerini ve ekli resimleri alın.

"mimeTypeAndTags"
Yalnızca MIME türünü ve meta veri etiketlerini alın.

"mimeTypeOnly"
Yalnızca MIME türünü alın.

MediaFileSystemMetadata

Özellikler

  • deviceId

    dize isteğe bağlı

    Medya galerisi çıkarılabilir bir cihazdaysa cihaz internete bağlıyken cihazın benzersiz kimliği.

  • galleryId

    dize

    Medya galerisi için benzersiz ve kalıcı bir kimlik.

  • isAvailable

    boolean

    Cihaz şu anda kullanılabiliyorsa doğru değerini döndürür.

  • isMediaDevice

    boolean

    Medya galerisinin bulunduğu cihaz, medya cihazı (ör. PTP veya MTP cihazı) olarak algılandıysa ya da DCIM dizini varsa doğru (true) olur.

  • isRemovable

    boolean

    Medya galerisi çıkarılabilir bir cihazdaysa doğru (true) değerini alır.

  • ad

    dize

    Dosya sisteminin adı.

MediaFileSystemsDetails

Özellikler

  • interactive

    GetMediaFileSystemsInteractivity isteğe bağlı

    İzin verilen grubu döndürmeden önce kullanıcıdan ek medya galerilerine izin vermesini isteyip istemeyeceğiniz. Varsayılan olarak sessizdir. "yes" değeri iletilirse veya uygulamaya herhangi bir medya galerisine erişim izni verilmemişse ve "if_needed" değeri iletilirse medya galerisi yapılandırma iletişim kutusu gösterilir.

MediaMetadata

Özellikler

  • albüm

    dize isteğe bağlı

    Ses ve video için tanımlanır.

  • sanatçı

    dize isteğe bağlı

  • attachedImages

    Blob[]

    Medya dosyasının meta verilerine yerleştirilmiş resimler. Bu özellik en çok albüm kapakları veya video küçük resimleri için kullanılır.

  • yorum

    dize isteğe bağlı

  • telif hakkı

    dize isteğe bağlı

  • disk

    number isteğe bağlı

  • süre

    number isteğe bağlı

    Ses ve video için tanımlanır. Saniye cinsinden.

  • tür

    dize isteğe bağlı

  • yükseklik

    number isteğe bağlı

    Video için tanımlanır. Piksel cinsinden.

  • language

    dize isteğe bağlı

  • mimeType

    dize

    Tarayıcının algıladığı MIME türü.

  • rawTags

    StreamInfo[]

    Medya dosyasındaki tüm meta veriler. Birden fazla akışı olan biçimlerde akış sırası korunur. Kapsayıcı meta verileri ilk öğedir.

  • döndürme

    number isteğe bağlı

    Video için tanımlanır. Derece cinsinden.

  • title

    dize isteğe bağlı

  • parça

    number isteğe bağlı

  • genişlik

    number isteğe bağlı

MediaMetadataOptions

Özellikler

  • metadataType

    GetMetadataType isteğe bağlı

    Alınacak meta verilerin alt kümesini belirtir. Seçenek atlanırsa varsayılan olarak "all" kullanılır.

StreamInfo

Özellikler

  • etiketler

    nesne

    Akış için etiketlerin filtrelenmemiş bir dize->dize sözlüğü.

  • tür

    dize

    Akışın kapsayıcı veya codec biçimini açıklar (ör. "mp3", "h264").

Yöntemler

addGalleryWatch()

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

Belirtilen galeri kimliğine sahip galeri için galeri izleme ekler. Ardından, belirtilen geri çağırma başarılı veya başarısız sonuçla birlikte tetiklenir.

Parametreler

İadeler

  • Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

addUserSelectedFolder()

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

Kullanıcıya bir dizin seçici sunun ve seçilen dizini galeri olarak ekleyin. Kullanıcı seçiciyi iptal ederse selectedFileSystemName boş olur. İletişim kutusunun gösterilmesi için kullanıcı hareketi gerekir. Kullanıcı hareketi olmadan geri çağırma, kullanıcı iptal etmiş gibi çalışır.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      dize

getMediaFileSystemMetadata()

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

Belirli bir medya dosyası sistemiyle ilgili meta verileri alma.

Parametreler

  • mediaFileSystem

    DOMFileSystem

İadeler

getMediaFileSystems()

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

Bu kullanıcı aracısında yapılandırılan medya galerilerini alın. Hiçbiri yapılandırılmamışsa veya kullanılamıyorsa geri çağırma boş bir dizi alır.

Parametreler

  • ayrıntılar

    MediaFileSystemsDetails isteğe bağlı

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

İadeler

  • Promise<DOMFileSystem[]>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getMetadata()

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

Bir medya dosyası için medyaya özgü meta verileri alır. Bu işlem, medya galerilerindeki dosyaların yanı sıra diğer DOM dosya sistemlerinde de çalışır.

Parametreler

İadeler

  • Promise<MediaMetadata>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeGalleryWatch()

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

Belirtilen galeri kimliğine sahip galeri için bir galeri saatini kaldırır.

Parametreler

  • galleryId

    dize

Etkinlikler

onGalleryChanged

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

Bir medya galerisi değiştirildiğinde veya galeri izleme bırakıldığında tetiklenir.

Parametreler