chrome.mediaGalleries

설명

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

권한

mediaGalleries

유형

AddGalleryWatchResult

속성

  • galleryId

    string

  • 성공

    boolean

GalleryChangeDetails

속성

  • galleryId

    string

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

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

GalleryChangeType

열거형

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

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

GetMediaFileSystemsInteractivity

열거형

"no"
상호작용하지 마세요.

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

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

GetMetadataType

열거형

"all"
MIME 유형, 메타데이터 태그, 첨부된 이미지를 검색합니다.

"mimeTypeAndTag"
MIME 유형 및 메타데이터 태그만 검색합니다.

"mimeTypeOnly"
MIME 유형만 검색합니다.

MediaFileSystemMetadata

속성

  • deviceId

    문자열 선택사항

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

  • galleryId

    string

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

  • isAvailable

    boolean

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

  • isMediaDevice

    boolean

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

  • isRemovable

    boolean

    미디어 갤러리가 이동식 기기에 있는 경우 true입니다.

  • 이름

    string

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

MediaFileSystemsDetails

속성

  • 양방향

    GetMediaFileSystemsInteractivity 선택사항

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

MediaMetadata

속성

  • album

    문자열 선택사항

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

  • 아티스트

    문자열 선택사항

  • attachedImages

    blob[]

    미디어 파일의 메타데이터에 삽입된 이미지입니다. 앨범 아트 또는 동영상 미리보기 이미지에 가장 많이 사용됩니다.

  • 댓글 수

    문자열 선택사항

  • 저작권

    문자열 선택사항

  • 디스크

    number 선택사항

  • 시간

    number 선택사항

    오디오 및 동영상에 대해 정의됩니다. 초 단위로 표시합니다.

  • 장르

    문자열 선택사항

  • 키

    number 선택사항

    동영상에 대해 정의됩니다. 픽셀로 표시합니다.

  • language

    문자열 선택사항

  • mimeType

    string

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

  • rawTags

    StreamInfo[]

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

  • 순환게재

    number 선택사항

    동영상에 대해 정의됩니다. 도 단위로 표시합니다.

  • title

    문자열 선택사항

  • 레이싱

    number 선택사항

  • 너비

    number 선택사항

MediaMetadataOptions

속성

  • metadataType

    GetMetadataType 선택사항

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

StreamInfo

속성

  • tags

    객체

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

  • 유형

    string

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

방법

addGalleryWatch()

프로미스 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

지정된 갤러리 ID로 갤러리용 갤러리 시계를 추가합니다. 그런 다음 주어진 콜백이 성공 또는 실패 결과와 함께 실행됩니다.

매개변수

반환 값

  • Chrome 116 이상

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

매개변수

  • 콜백

    기능

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      string

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

매개변수

  • mediaFileSystem

    DOMFileSystem

반환 값

getMediaFileSystems()

프로미스 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

이 사용자 에이전트에 구성된 미디어 갤러리를 가져옵니다. 구성되거나 사용 가능한 것이 없으면 콜백은 빈 배열을 수신합니다.

매개변수

  • 세부정보

    MediaFileSystemsDetails 선택사항

  • 콜백

    함수 선택사항

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

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      DOMFileSystem[]

반환 값

  • Promise<DOMFileSystem[]>

    Chrome 116 이상

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

getMetadata()

프로미스 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

미디어 파일의 미디어별 메타데이터를 가져옵니다. 이 기능은 미디어 갤러리의 파일 및 기타 DOM 파일 시스템에서도 작동합니다.

매개변수

반환 값

  • Promise<MediaMetadata>

    Chrome 116 이상

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

지정된 갤러리 ID가 있는 갤러리의 갤러리 시계를 삭제합니다.

매개변수

  • galleryId

    string

이벤트

onGalleryChanged

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

미디어 갤러리가 변경되거나 갤러리 시계가 삭제되면 실행됩니다.

매개변수