Getting Started
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-ricoh360`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/ricoh360-camera/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins다음 명령어를 사용하여 다음 프롬프트를 사용하세요:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-ricoh360` plugin in my project.만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래에 플랫폼에 따라 설명된 지침을 따르세요:
npm install @capgo/capacitor-ricoh360npx cap syncimport { Ricoh360Camera } from '@capgo/capacitor-ricoh360';API 개요
Section titled “API 개요”각 예제는 Snippet를 복사하기 위해 import를 반복합니다.
initialize
Section titled “initialize”SDK를 카메라 URL로 초기화합니다.
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.initialize({} as InitializeOptions);getCameraAsset
Section titled “getCameraAsset”URL에서 카메라 자산을 가져와 base64로 반환합니다.
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.getCameraAsset({} as GetCameraAssetOptions);listFiles
Section titled “listFiles”카메라에 저장된 파일 목록
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.listFiles();capturePicture
capturePicture 섹션사진 촬영
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.capturePicture();captureVideo
captureVideo 섹션비디오 촬영
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.captureVideo({} as VideoCaptureOptions);livePreview
livePreview 섹션실시간 미리보기 시작
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.livePreview({} as LivePreviewOptions);stopLivePreview
stopLivePreview 섹션실시간 미리보기 중지
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.stopLivePreview();readSettings
readSettings 섹션카메라 설정 읽기
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.readSettings({} as { options: string[] });setSettings
setSettings 섹션카메라 설정 설정
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.setSettings({} as { options: Record<string, any> });sendCommand
sendCommand 섹션카메라에 raw 명령 보내기
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
await Ricoh360Camera.sendCommand({} as { endpoint: string; payload: Record<string, any> });타입 참조
타입 참조 섹션InitializeOptions
초기화 옵션 섹션export interface InitializeOptions { url: string;}CommandResponse
명령어 응답 섹션export interface CommandResponse { session?: string; info?: string; preview?: string; picture?: string; settings?: string;}GetCameraAssetOptions
카메라 자산 가져오기 옵션 섹션export interface GetCameraAssetOptions { url: string; saveToFile?: boolean;}GetCameraAssetResponse
카메라 자산 가져오기 응답 섹션export interface GetCameraAssetResponse { statusCode: number; data: string; // base64 encoded data filePath?: string;}ListFilesOptions
파일 목록 가져오기 옵션 섹션export interface ListFilesOptions { fileType?: 'all' | 'image' | 'video'; startPosition?: number; entryCount?: number; maxThumbSize?: number; _detail?: boolean;}ListFilesResponse
파일 목록 가져오기 응답 섹션export interface ListFilesResponse { results: { entries: { name: string; fileUrl: string; size: number; dateTimeZone: string; width?: number; height?: number; previewUrl?: string; _projectionType?: string; isProcessed?: boolean; _thumbSize?: number; }[]; totalEntries: number; };}VideoCaptureOptions
'비디오 캡처 옵션' 섹션export interface VideoCaptureOptions { // Define any specific options needed for capturing a video resolution?: '4K' | '2K'; frameRate?: number; bitrate?: number;}LivePreviewOptions
'라이브 프리뷰 옵션' 섹션export interface LivePreviewOptions { displayInFront?: boolean; cropPreview?: boolean;}실제 데이터 원천
'실제 데이터 원천' 섹션이 페이지는 플러그인의 src/definitions.tsAPI이 업스트림에서 변경될 때 다시 동기화하세요.
Getting Started에서 계속
'Getting Started에서 계속' 섹션이미지 또는 비디오를 사용 중입니다. Getting Started native 미디어 및 인터페이스 동작을 계획하고 연결하기 위해 Using @capgo/capacitor-live-activities native 기능을 위한 Using @capgo/capacitor-live-activities @capgo/capacitor-live-activities native 기능 구현 세부 사항을 위한 @capgo/capacitor-live-activities Using @capgo/capacitor-video-player native 기능을 위한 Using @capgo/capacitor-video-player @capgo/capacitor-video-player native 기능 구현 세부 사항을 위한 @capgo/capacitor-video-player, Using @capgo/capacitor-native-navigation native 기능을 위한 Using @capgo/capacitor-native-navigation.