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'yi 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"
Kol saati, cihaz çıkarıldığı veya galeri izni kaldırıldığı ya da başka bir nedenle bırakıldı.

GetMediaFileSystemsInteractivity

Enum

"no"
Etkileşimli olarak hareket etmeyin.

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

"if_needed"
Kullanıcıdan, izin verilen galerileri yönetmesini yalnızca iade grubu aksi halde boş kalacaksa 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

    string isteğe bağlı

    Medya galerisi bir çıkarılabilir cihazdaysa internete bağlı olan 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 alır.

  • isMediaDevice

    boolean

    Medya galerisinin bulunduğu cihaz, bir medya cihazı olarak (yani bir PTP veya MTP cihazı olarak) algılanmışsa ya da bir DCIM dizini mevcutsa doğru değerini alır.

  • isRemovable

    boolean

    Medya galerisi bir çıkarılabilir 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 isteyip istemeyeceğini belirler. Varsayılan ayar sessizdir. "yes" değeri iletilirse veya uygulamaya herhangi bir medya galerisine erişim izni verilmezse ve "if_needed" değeri aktarılırsa medya galerisi yapılandırma iletişim kutusu görüntülenir.

MediaMetadata

Özellikler

  • album

    string isteğe bağlı

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

  • sanatçı

    string isteğe bağlı

  • attachedImages

    Blob[]

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

  • yorum

    string isteğe bağlı

  • telif hakkı

    string isteğe bağlı

  • disk

    numara isteğe bağlı

  • süre

    numara isteğe bağlı

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

  • tür

    string isteğe bağlı

  • yükseklik

    numara isteğe bağlı

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

  • dil

    string isteğe bağlı

  • mimeType

    dize

    Tarayıcı, mime türünü yok saydı.

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

  • rotasyon

    numara isteğe bağlı

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

  • title

    string isteğe bağlı

  • parça

    numara isteğe bağlı

  • genişlik

    numara isteğe bağlı

MediaMetadataOptions

Özellikler

  • metadataType

    GetMetadataType isteğe bağlı

    Alınacak meta veri alt kümesini belirtir. Seçenek atlanırsa varsayılan olarak "tümü" olur.

StreamInfo

Özellikler

  • etiketler

    nesne

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

  • tür

    dize

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

Yöntemler

addGalleryWatch()

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

Belirtilen galeri kimliğiyle galeri için bir galeri saati ekler. Ardından, söz konusu geri çağırma, bir başarılı veya başarısız sonuçla tetiklenir.

Parametreler

İlerlemeler

  • Chrome 116 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Kullanıcıya bir dizin seçici sunun ve seçilen dizini galeri olarak ekleyin. Kullanıcı seçiciyi iptal ederse seçiliFileSystemName boş olur. İletişim kutusunun gösterilebilmesi için kullanıcı hareketi gereklidir. Kullanıcı hareketi olmadan geri çağırma, 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

      DOMDosya Sistemi[]

    • selectedFileSystemName

      dize

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Belirli bir medya dosya sistemiyle ilgili meta verileri alma.

Parametreler

  • mediaFileSystem

    DOMFileSystem

İlerlemeler

getMediaFileSystems()

Söz 
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ılabilir değilse geri çağırma işlemi boş bir dizi alır.

Parametreler

  • ayrıntılar

    MediaFileSystemsDetails isteğe bağlı

  • geri çağırma

    Functions (isteğe bağlı)

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

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      DOMDosya Sistemi[]

İlerlemeler

  • Promise<DOMFileSystem[]>

    Chrome 116 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getMetadata()

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

Bir medya dosyası için medyaya özel meta verileri alır. Bu işlemin medya galerilerindeki dosyalar ve diğer DOM dosya sistemleri için çalışması gerekir.

Parametreler

İlerlemeler

  • Promise<MediaMetadata>

    Chrome 116 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Belirtilen galeri kimliğine sahip galeri izlemesini kaldırır.

Parametreler

  • galleryId

    dize

Etkinlikler

onGalleryChanged

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

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

Parametreler