chrome.mediaGalleries

Açıklama

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

İ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 çıkarıldığı, galeri izni kaldırıldığı veya başka bir nedenle saat düşürüldü.

GetMediaFileSystemsInteractivity

Enum

"no"
Etkileşimli hareket etmeyin.

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

"if_needed"
Kullanıcıdan izin verilen galerileri yönetmesini isteyin (yalnızca dönüş seti boş kalacaksa).

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ır.

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.

  • Kullanılabilir

    boolean

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

  • isMediaDevice

    boolean

    Medya galerisinin bulunduğu cihaz, bir medya cihazı olarak algılanırsa doğru değerini döndürür. Örneğin, bir PTP veya MTP cihazı ya da bir DCIM dizini mevcut olmalıdır.

  • isRemovable

    boolean

    Medya galerisi çıkarılabilir bir cihazdaysa doğru 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 galerileri için izin istenip istenmeyeceğini belirler. Varsayılan ayar sessizdir. "Evet" değeri veya uygulamaya herhangi bir medya galerisine erişim izni verilmediyse ve "if_needed" değeri iletildiğinde, medya galerisi yapılandırma iletişim kutusu görüntülenir.

MediaMetadata

Özellikler

  • albüm

    dize isteğe bağlı

    Ses ve video için tanımlanmıştır.

  • sanatçı

    dize isteğe bağlı

  • attachedImages

    Blob[]

    Medya dosyasının meta verilerine yerleştirilen resimler. Bu seçenek genellikle albüm kapağı veya video küçük resimleri için kullanılır.

  • yorum

    dize isteğe bağlı

  • telif hakkı

    dize isteğe bağlı

  • disk

    sayı isteğe bağlı

  • süre

    sayı isteğe bağlı

    Ses ve video için tanımlanmıştır. Saniye cinsinden.

  • tür

    dize isteğe bağlı

  • yükseklik

    sayı isteğe bağlı

    Video için tanımlanmış. Piksel cinsinden.

  • language

    dize isteğe bağlı

  • mimeType

    dize

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

  • 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.

  • rotasyon

    sayı isteğe bağlı

    Video için tanımlanmış. Derece olarak.

  • title

    dize isteğe bağlı

  • parça

    sayı isteğe bağlı

  • genişlik

    sayı isteğe bağlı

MediaMetadataOptions

Özellikler

  • metadataType

    GetMetadataType isteğe bağlı

    Meta verinin hangi alt kümesinin alınacağını belirtir. Varsayılan olarak "all" değerine ayarlanır (seçenek atlanırsa).

StreamInfo

Özellikler

  • etiketler

    nesne

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

  • tür

    dize

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

Yöntemler

addGalleryWatch()

Söz 'nı inceleyin.
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Belirtilen galeri kimliğine sahip galeri için bir galeri saati ekler. Daha sonra belirtilen geri çağırma, başarılı veya başarısız bir sonuçla tetiklenir.

Parametreler

İadeler

  • Promise<AddGalleryWatchResult>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Kullanıcıya bir dizin seçici gösterin 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 gereklidir. Kullanıcı hareketi olmadığında geri arama, kullanıcı iptal etmiş gibi çalışır.

Parametreler

  • geri çağırma

    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,
)

Belirli bir medya dosya sistemiyle ilgili meta verileri alma.

Parametreler

  • mediaFileSystem

    DOMFileSystem

İadeler

getMediaFileSystems()

Söz 'nı inceleyin.
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

Parametreler

  • ayrıntılar

    MediaFileSystemsDetails isteğe bağlı

  • geri çağırma

    işlev isteğe bağlı

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

İadeler

  • Promise<DOMFileSystem[]>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getMetadata()

Söz 'nı inceleyin.
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

Bir medya dosyası için medyaya özel meta verileri alır. Bu, medya galerilerindeki ve diğer DOM dosya sistemlerindeki dosyalar için işe yarayacaktır.

Parametreler

İadeler

  • Promise<MediaMetadata>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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 galerideki bir kol saati bırakıldığında tetiklenir.

Parametreler