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
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()
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
-
galleryId
dize
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: AddGalleryWatchResult) => void
-
sonuç
-
İlerlemeler
-
Promise<AddGalleryWatchResult>
Chrome 116 ve sonraki sürümlerVaatler 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
-
MediaFileSystemMetadata | tanımlanmamış
getMediaFileSystems()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getMetadata()
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
-
mediaFile
Blob
-
seçenekler
MediaMetadataOptions isteğe bağlı
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(metadata: MediaMetadata) => void
-
metadata
-
İlerlemeler
-
Promise<MediaMetadata>
Chrome 116 ve sonraki sürümlerVaatler 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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: GalleryChangeDetails) => void
-
ayrıntılar
-