설명
사용자 동의가 있는 경우 chrome.mediaGalleries
API를 사용하여 사용자의 로컬 디스크에 있는 미디어 파일(오디오, 이미지, 동영상)에 액세스합니다.
권한
mediaGalleries
유형
AddGalleryWatchResult
속성
-
galleryId
문자열
-
성공
boolean
GalleryChangeDetails
속성
-
galleryId
문자열
수정된 갤러리를 식별합니다.
-
변경 이벤트의 유형입니다.
GalleryChangeType
enum
"contents_changed"
갤러리 콘텐츠가 변경되었습니다.
"watch_dropped"
기기가 분리되었거나 갤러리 권한이 삭제되었거나 기타 이유로 시계가 삭제되었습니다.
GetMediaFileSystemsInteractivity
enum
"no"
상호작용하지 마세요.
"yes"
사용자에게 허용된 미디어 갤러리를 관리하도록 요청합니다.
'if_needed'
반품 세트가 비어 있는 경우에만 허용된 갤러리를 관리하도록 사용자에게 요청합니다.
GetMetadataType
enum
"all"
MIME 유형, 메타데이터 태그, 첨부된 이미지를 검색합니다.
"mimeTypeAndTag"
MIME 유형 및 메타데이터 태그만 검색합니다.
"mimeTypeOnly"
MIME 유형만 검색합니다.
MediaFileSystemMetadata
속성
-
deviceId
문자열 선택사항
미디어 갤러리가 이동식 기기에 있는 경우 기기가 온라인 상태일 때 기기의 고유 ID입니다.
-
galleryId
문자열
미디어 갤러리의 고유하고 영구적인 ID입니다.
-
isAvailable
boolean
현재 기기를 사용할 수 있는 경우 true입니다.
-
isMediaDevice
boolean
미디어 갤러리가 있는 기기가 미디어 기기(예: PTP 또는 MTP 기기 또는 DCIM 디렉터리)로 감지된 경우 true입니다.
-
isRemovable
boolean
미디어 갤러리가 이동식 기기에 있는 경우 true입니다.
-
이름
문자열
파일 시스템의 이름입니다.
MediaFileSystemsDetails
속성
-
양방향
허용된 세트를 반환하기 전에 사용자에게 추가 미디어 갤러리에 대한 권한을 요청할지 여부입니다. 기본값은 무음입니다. 'yes' 값이 전달되거나 애플리케이션에 미디어 갤러리에 대한 액세스 권한이 부여되지 않았고 'if_needed' 값이 전달된 경우 미디어 갤러리 구성 대화상자가 표시됩니다.
MediaMetadata
속성
-
album
문자열 선택사항
오디오 및 동영상에 대해 정의됩니다.
-
아티스트
문자열 선택사항
-
attachedImages
blob[]
미디어 파일의 메타데이터에 삽입된 이미지입니다. 앨범 아트 또는 동영상 미리보기 이미지에 가장 많이 사용됩니다.
-
댓글 수
문자열 선택사항
-
저작권
문자열 선택사항
-
디스크
number 선택사항
-
시간
number 선택사항
오디오 및 동영상에 대해 정의됩니다. 초 단위로 표시합니다.
-
장르
문자열 선택사항
-
키
number 선택사항
동영상에 대해 정의됩니다. 픽셀로 표시합니다.
-
language
문자열 선택사항
-
mimeType
문자열
브라우저에서 스니핑된 MIME 유형입니다.
-
rawTags
미디어 파일의 모든 메타데이터입니다. 스트림이 여러 개인 형식의 경우 스트림 순서가 유지됩니다. 컨테이너 메타데이터는 첫 번째 요소입니다.
-
순환게재
number 선택사항
동영상에 대해 정의됩니다. 도 단위로 표시합니다.
-
title
문자열 선택사항
-
레이싱
number 선택사항
-
너비
number 선택사항
MediaMetadataOptions
속성
-
metadataType
GetMetadataType 선택사항
검색할 메타데이터 하위 집합을 지정합니다. 옵션을 생략할 경우 기본값은 'all'입니다.
StreamInfo
속성
-
tags
객체
스트림용 태그의 필터링되지 않은 문자열 -> 문자열 사전입니다.
-
유형
문자열
스트림의 컨테이너 또는 코덱 형식을 설명합니다(예: 'mp3', 'h264').
메서드
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
지정된 갤러리 ID로 갤러리용 갤러리 시계를 추가합니다. 그런 다음 주어진 콜백이 성공 또는 실패 결과와 함께 실행됩니다.
매개변수
-
galleryId
문자열
-
callback
함수 선택사항
callback
매개변수는 다음과 같습니다.(result: AddGalleryWatchResult) => void
반환 값
-
Promise<AddGalleryWatchResult>
Chrome 116 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
addUserSelectedFolder()
chrome.mediaGalleries.addUserSelectedFolder(
callback: function,
)
사용자에게 디렉터리 선택 도구를 표시하고 선택한 디렉터리를 갤러리로 추가합니다. 사용자가 선택기를 취소하면 selectedFileSystemName이 비어 있게 됩니다. 대화상자를 표시하려면 사용자 동작이 필요합니다. 사용자 동작이 없으면 사용자가 취소한 것처럼 콜백이 실행됩니다.
매개변수
-
callback
기능
callback
매개변수는 다음과 같습니다.(mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void
-
mediaFileSystems
DOMFileSystem[]
-
selectedFileSystemName
문자열
-
getMediaFileSystemMetadata()
chrome.mediaGalleries.getMediaFileSystemMetadata(
mediaFileSystem: DOMFileSystem,
)
특정 미디어 파일 시스템에 관한 메타데이터를 가져옵니다.
매개변수
-
mediaFileSystem
DOMFileSystem
반환 값
-
MediaFileSystemMetadata | 정의되지 않음
getMediaFileSystems()
chrome.mediaGalleries.getMediaFileSystems(
details?: MediaFileSystemsDetails,
callback?: function,
)
이 사용자 에이전트에 구성된 미디어 갤러리를 가져옵니다. 구성되거나 사용 가능한 것이 없으면 콜백은 빈 배열을 수신합니다.
매개변수
-
세부정보
-
callback
함수 선택사항
callback
매개변수는 다음과 같습니다.(mediaFileSystems: DOMFileSystem[]) => void
-
mediaFileSystems
DOMFileSystem[]
-
반환 값
-
Promise<DOMFileSystem[]>
Chrome 116 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
getMetadata()
chrome.mediaGalleries.getMetadata(
mediaFile: Blob,
options?: MediaMetadataOptions,
callback?: function,
)
미디어 파일의 미디어별 메타데이터를 가져옵니다. 이 기능은 미디어 갤러리의 파일 및 기타 DOM 파일 시스템에서도 작동합니다.
매개변수
-
mediaFile
Blob
-
옵션
MediaMetadataOptions 선택사항
-
callback
함수 선택사항
callback
매개변수는 다음과 같습니다.(metadata: MediaMetadata) => void
-
metadata
-
반환 값
-
Promise<MediaMetadata>
Chrome 116 이상프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.
removeGalleryWatch()
chrome.mediaGalleries.removeGalleryWatch(
galleryId: string,
)
지정된 갤러리 ID가 있는 갤러리의 갤러리 시계를 삭제합니다.
매개변수
-
galleryId
문자열
이벤트
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
미디어 갤러리가 변경되거나 갤러리 시계가 삭제되면 실행됩니다.
매개변수
-
callback
기능
callback
매개변수는 다음과 같습니다.(details: GalleryChangeDetails) => void
-
세부정보
-