가이드
How to use File Picker in Capacitor
@capgo/capacitor-file-picker을 사용하는 방법
Capacitor 파일 픽커 플러그인: 파일, 이미지, 비디오 및 디렉토리를 선택하기 위한 인터페이스
설치
bun add @capgo/capacitor-file-picker
bunx cap sync
bunx cap sync code의 네이티브 코드를 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.
import
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
API의 기능을 한눈에
| 메서드 | Description |
|---|---|
pickFiles |
갤러리에서 하나 이상의 이미지를 선택합니다. (안드로이드/아이오스 전용) |
pickImages |
갤러리에서 하나 이상의 비디오를 선택합니다. (안드로이드/아이오스 전용) |
pickVideos |
__CAPGO_KEEP_0__ |
pickMedia |
갤러리에서 하나 이상의 이미지 또는 비디오를 선택하세요. Android/iOS만. |
pickDirectory |
장치에서 폴더를 선택하세요. Android/iOS만. |
convertHeicToJpeg |
iOS에서 HEIC 이미지 형식을 JPEG 형식으로 변환하세요. |
copyFile |
파일을 새로운 위치로 복사하세요. |
checkPermissions |
Android 13 이상에서 광범위한 저장소 또는 미디어 권한 상태를 확인하세요. 픽커 전용 흐름은 이 권한에 의존해서는 안 됩니다. pickFiles(), pickImages(), pickVideos()또는 pickMedia() 안드로이드 13+에서 이 권한을 사용합니다. 안드로이드 전용. |
requestPermissions |
or READ_MEDIA_IMAGES or READ_MEDIA_VIDEO or @capgo/capacitor-file-picker or |
예시
pickFiles()
장치에서 하나 이상의 파일을 선택하세요.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickFiles({
types: ['application/pdf', 'image/*'],
limit: 5,
readData: false
});
console.log('Picked files:', result.files);
pickImages()
갤러리에서 하나 이상의 이미지를 선택하세요. (Android, iOS만)
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickImages({
limit: 10,
readData: false
});
console.log('Picked images:', result.files);
pickVideos()
갤러리에서 하나 이상의 비디오를 선택하세요. (Android, iOS만)
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickVideos({
limit: 3,
skipTranscoding: true
});
console.log('Picked videos:', result.files);
pickMedia()
갤러리에서 하나 이상의 이미지를 또는 비디오를 선택하세요. (Android, iOS만)
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickMedia({
limit: 5,
readData: true
});
console.log('Picked media:', result.files);
pickDirectory()
장치에서 하나의 폴더를 선택하세요. (Android, iOS만)
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);
convertHeicToJpeg()
iOS에서 HEIC 이미지를 JPEG 형식으로 변환하세요.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.convertHeicToJpeg({
path: '/path/to/image.heic',
quality: 0.9
});
console.log('Converted file:', result.path);
위 표에는 9개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 __CAPGO_KEEP_0__ 저장소에서 문서화되어 있습니다. GitHub 저장소.
핸들 반환. 화면이 언마운트되면 또는
addListener 모든 리스너를 해제하세요. handle.remove() 화면이 언마운트되면 또는 CapgoFilePicker.removeAllListeners() 모든 리스너를 해제하세요.
전체 참조
@capgo/capacitor-파일 선택기에서 계속 사용하세요
Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-picker @capgo/capacitor-파일 선택기 storage 및 파일 처리를 계획하고 연결하려면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-picker @capgo/capacitor-파일 선택기 @capgo/capacitor-file-picker Getting Started Getting Started @capgo/capacitor-SQLite 데이터 저장소 @capgo/capacitor-data-storage-sqlite Capacitor @capgo/capacitor-data-storage-sqlite Capacitor @capgo/capacitor-data-storage-sqlite @capgo/capacitor-파일 @capgo/capacitor-파일 구현 세부 사항을 위해