chrome.mediaGalleries

Açıklama

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

İzinler

mediaGalleries

Kullanılabilirlik

Yalnızca ChromeOS

Türler

AddGalleryWatchResult

Özellikler

  • galleryId

    dize

  • başarılı

    boole

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 bağlantısı kesildiği, galeri izni kaldırıldığı veya başka bir nedenle izleme bırakıldı.

GetMediaFileSystemsInteractivity

Enum

"no"
Etkileşimli olarak işlem yapmayın.

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

"if_needed"
Yalnızca döndürülen küme boşsa kullanıcıdan izin verilen galerileri yönetmesini isteyin.

GetMetadataType

Enum

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

"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

    string isteğe bağlı

    Medya galerisi çıkarılabilir bir cihazdaysa cihaz çevrimiçiyken cihazın benzersiz kimliği.

  • galleryId

    dize

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

  • isAvailable

    boole

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

  • isMediaDevice

    boole

    Medya galerisinin bulunduğu cihaz bir medya cihazı (ör. PTP veya MTP cihazı) olarak algılanırsa ya da bir DCIM dizini varsa "true" değerini alır.

  • isRemovable

    boole

    Medya galerisi çıkarılabilir bir cihazdaysa doğru değerini döndürür.

  • ad

    dize

    Dosya sisteminin adı.

MediaFileSystemsDetails

Özellikler

  • etkileşimli

    GetMediaFileSystemsInteractivity isteğe bağlı

    İzin verilen grubu döndürmeden önce kullanıcıdan ek medya galerileri için izin istenip istenmeyeceği. 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

    string isteğe bağlı

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

  • sanatçı

    string isteğe bağlı

  • attachedImages

    Blob[]

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

  • yorum

    string isteğe bağlı

  • telif hakkı

    string 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

    string isteğe bağlı

  • yükseklik

    number isteğe bağlı

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

  • language

    string isteğe bağlı

  • mimeType

    dize

    Tarayıcı tarafından algılanan MIME türü.

  • rawTags

    StreamInfo[]

    Medya dosyasındaki tüm meta veriler. Birden fazla akış içeren 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

    string 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ı

    Meta verilerin hangi alt kümesinin alınacağını belirtir. Seçenek belirtilmezse varsayılan olarak "all" (tümü) kullanılır.

StreamInfo

Özellikler

  • etiketler

    nesne

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

  • tür

    dize

    Kapsayıcının biçimini veya akışın codec'ini (ör. "mp3", "h264") açıklar.

Yöntemler

addGalleryWatch()

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

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

Parametreler

İadeler

  • Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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 dosya sistemiyle ilgili meta verileri alma

Parametreler

  • mediaFileSystem

    DOMFileSystem

İadeler

getMediaFileSystems()

Taahhüt 
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ış veya mevcut değilse geri çağırma boş bir dizi alır.

Parametreler

  • ayrıntılar

    MediaFileSystemsDetails isteğe bağlı

  • callback

    function isteğe bağlı

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

İadeler

  • Söz<DOMFileSystem[]>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getMetadata()

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

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

Parametreler

İadeler

  • Promise<MediaMetadata>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeGalleryWatch()

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

Belirtilen galeri kimliğine sahip galerinin izleme listesinden çıkarılmasını sağlar.

Parametreler

  • galleryId

    dize

Etkinlikler

onGalleryChanged

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

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

Parametreler