chrome.mediaGalleries

설명

chrome.mediaGalleries API를 사용하여 사용자의 동의를 얻어 사용자의 로컬 디스크에서 미디어 파일(오디오, 이미지, 동영상)에 액세스합니다.

권한

mediaGalleries

유형

AddGalleryWatchResult

속성

  • galleryId

    문자열

  • 성공

    부울

GalleryChangeDetails

속성

  • galleryId

    문자열

    수정된 갤러리를 식별합니다.

  • 변경 이벤트 유형입니다.

GalleryChangeType

열거형

"contents_changed"
갤러리의 콘텐츠가 변경되었습니다.

'watch_dropped'
기기가 분리되었거나, 갤러리 권한이 삭제되었거나, 기타 이유로 시계가 삭제되었습니다.

GetMediaFileSystemsInteractivity

열거형

'아니요'
대화형으로 행동하지 마세요.

'yes'
사용자에게 허용된 미디어 갤러리를 관리하도록 요청합니다.

'if_needed'
반환된 세트가 비어 있는 경우에만 사용자에게 허용된 갤러리를 관리하도록 요청합니다.

GetMetadataType

열거형

'all'
MIME 유형, 메타데이터 태그, 첨부된 이미지를 가져옵니다.

"mimeTypeAndTags"
MIME 유형과 메타데이터 태그만 가져옵니다.

'mimeTypeOnly'
MIME 유형만 가져옵니다.

MediaFileSystemMetadata

속성

  • deviceId

    문자열 선택사항

    미디어 갤러리가 이동식 기기에 있는 경우 기기가 온라인 상태일 때 기기의 고유 ID입니다.

  • galleryId

    문자열

    미디어 갤러리의 고유 영구 ID입니다.

  • isAvailable

    부울

    기기를 현재 사용할 수 있는 경우 true입니다.

  • isMediaDevice

    부울

    미디어 갤러리가 있는 기기가 미디어 기기(예: PTP 또는 MTP 기기)로 감지되었거나 DCIM 디렉터리가 있는 경우 true입니다.

  • isRemovable

    부울

    미디어 갤러리가 이동식 기기에 있으면 true입니다.

  • 이름

    문자열

    파일 시스템의 이름입니다.

MediaFileSystemsDetails

속성

  • 양방향

    GetMediaFileSystemsInteractivity 선택사항

    허용된 세트를 반환하기 전에 사용자에게 추가 미디어 갤러리에 대한 권한을 요청할지 여부입니다. 기본값은 무음입니다. 'yes' 값이 전달되거나 애플리케이션에 미디어 갤러리 액세스 권한이 부여되지 않았고 'if_needed' 값이 전달되면 미디어 갤러리 구성 대화상자가 표시됩니다.

MediaMetadata

속성

  • 앨범

    문자열 선택사항

    오디오 및 동영상에 대해 정의됩니다.

  • 아티스트

    문자열 선택사항

  • attachedImages

    Blob[]

    미디어 파일의 메타데이터에 삽입된 이미지입니다. 이 속성은 앨범 아트 또는 동영상 썸네일에 가장 자주 사용됩니다.

  • 댓글 수

    문자열 선택사항

  • 저작권

    문자열 선택사항

  • 디스크

    번호 선택사항

  • 기간

    번호 선택사항

    오디오 및 동영상에 대해 정의됩니다. 초 단위입니다.

  • 장르

    문자열 선택사항

  • 높이

    번호 선택사항

    동영상에 대해 정의됩니다. 단위는 픽셀입니다.

  • language

    문자열 선택사항

  • mimeType

    문자열

    브라우저에서 스니핑한 MIME 유형입니다.

  • rawTags

    StreamInfo[]

    미디어 파일의 모든 메타데이터입니다. 스트림이 여러 개인 형식의 경우 스트림 순서가 유지됩니다. 컨테이너 메타데이터가 첫 번째 요소입니다.

  • 회전

    번호 선택사항

    동영상에 대해 정의됩니다. 단위는 도입니다.

  • 제목

    문자열 선택사항

  • 레이싱

    번호 선택사항

  • 너비

    번호 선택사항

MediaMetadataOptions

속성

  • metadataType

    GetMetadataType 선택사항

    검색할 메타데이터의 하위 집합을 지정합니다. 이 옵션을 생략하면 기본값은 'all'입니다.

StreamInfo

속성

  • tags

    객체

    스트림의 필터링되지 않은 문자열->문자열 태그 사전입니다.

  • 유형

    문자열

    스트림의 컨테이너 또는 코덱 형식을 설명합니다(예: 'mp3', 'h264').

메서드

addGalleryWatch()

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

지정된 갤러리 ID가 있는 갤러리에 갤러리 감시를 추가합니다. 그러면 지정된 콜백이 성공 또는 실패 결과와 함께 실행됩니다.

매개변수

반환 값

  • Chrome 116 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

사용자에게 디렉터리 선택기를 표시하고 선택한 디렉터리를 갤러리로 추가합니다. 사용자가 선택기를 취소하면 selectedFileSystemName이 비어 있습니다. 대화상자를 표시하려면 사용자 동작이 필요합니다. 사용자 동작이 없으면 콜백이 사용자가 취소한 것처럼 실행됩니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      문자열

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

특정 미디어 파일 시스템에 관한 메타데이터를 가져옵니다.

매개변수

  • mediaFileSystem

    DOMFileSystem

반환 값

getMediaFileSystems()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

이 사용자 에이전트에서 구성된 미디어 갤러리를 가져옵니다. 구성된 항목이 없거나 사용할 수 없는 경우 콜백은 빈 배열을 수신합니다.

매개변수

  • 세부정보

    MediaFileSystemsDetails 선택사항

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

반환 값

  • Promise<DOMFileSystem[]>

    Chrome 116 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getMetadata()

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

미디어 파일의 미디어별 메타데이터를 가져옵니다. 이는 미디어 갤러리의 파일과 다른 DOM 파일 시스템에서도 작동해야 합니다.

매개변수

반환 값

  • Promise<MediaMetadata>

    Chrome 116 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

removeGalleryWatch()

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

지정된 갤러리 ID의 갤러리 시청을 삭제합니다.

매개변수

  • galleryId

    문자열

이벤트

onGalleryChanged

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

미디어 갤러리가 변경되거나 갤러리 감시가 삭제될 때 발생합니다.

매개변수