chrome.mediaGalleries

설명

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

권한

mediaGalleries

유형

AddGalleryWatchResult

속성

  • galleryId

    문자열

  • 성공

    부울

GalleryChangeDetails

속성

  • galleryId

    문자열

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

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

GalleryChangeType

열거형

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

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

GetMediaFileSystemsInteractivity

열거형

"no"
대화식으로 행동하지 마세요.

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

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

GetMetadataType

열거형

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

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

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

MediaFileSystemMetadata

속성

  • deviceId

    문자열(선택사항)

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

  • galleryId

    문자열

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

  • isAvailable

    부울

    현재 기기를 사용할 수 있으면 true입니다.

  • isMediaDevice

    부울

    미디어 갤러리가 있는 기기가 미디어 기기로 감지된 경우 true입니다. 즉, PTP 또는 MTP 기기 또는 DCIM 디렉터리가 존재하는 경우입니다.

  • isRemovable

    부울

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

  • 이름

    문자열

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

MediaFileSystemsDetails

속성

  • 양방향

    GetMediaFileSystemsInteractivity 선택사항

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

MediaMetadata

속성

  • 앨범

    문자열(선택사항)

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

  • 아티스트

    문자열(선택사항)

  • attachedImages

    블롭[]

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

  • 댓글 수

    문자열(선택사항)

  • 저작권

    문자열(선택사항)

  • 디스크

    숫자 선택사항

  • 기간

    숫자 선택사항

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

  • 장르

    문자열(선택사항)

  • 높이

    숫자 선택사항

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

  • language

    문자열(선택사항)

  • mimeType

    문자열

    브라우저가 MIME 유형을 스니핑했습니다.

  • rawTags

    StreamInfo[]

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

  • 회전

    숫자 선택사항

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

  • 제목

    문자열(선택사항)

  • 레이싱

    숫자 선택사항

  • 너비

    숫자 선택사항

MediaMetadataOptions

속성

  • metadataType

    GetMetadataType 선택사항

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

StreamInfo

속성

  • tags

    객체

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

  • 유형

    문자열

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

메서드

addGalleryWatch()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

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

매개변수

반환 값

  • Promise&lt;AddGalleryWatchResult&gt;

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

매개변수

  • 콜백

    함수

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      문자열

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

매개변수

  • mediaFileSystem

    DOMFileSystem

반환 값

getMediaFileSystems()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

매개변수

  • 세부정보

    MediaFileSystemsDetails 선택사항

  • 콜백

    함수 선택사항

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

반환 값

  • Promise&lt;DOMFileSystem[]&gt;

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getMetadata()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

미디어 파일의 미디어별 메타데이터를 가져옵니다. 이는 미디어 갤러리의 파일뿐 아니라 다른 DOM 파일 시스템에도 적용됩니다.

매개변수

반환 값

  • Promise&lt;MediaMetadata&gt;

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

매개변수

  • galleryId

    문자열

이벤트

onGalleryChanged

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

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

매개변수