Primeros pasos
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
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.
Instalar
Sección titulada “Instalación”Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:
bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsLuego usa el siguiente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-ricoh360` plugin in my project.Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:
bun add @capgo/capacitor-ricoh360bunx cap syncImportar
Sección titulada “Importar”import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';Inicio rápido
Sección titulada “Inicio rápido”import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.initialize({ url: 'https://example.com' });console.log(result);Ejemplo: getCameraAsset
Sección titulada “Ejemplo: getCameraAsset”import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.getCameraAsset({ url: 'https://example.com' });console.log(result);Ejemplo: listFiles
Sección titulada “Ejemplo: listFiles”import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.listFiles();console.log(result);Errores comunes
Sección titulada “Errores comunes”- Inicializa una vez: ejecuta setup durante el bootstrap de la app.
- Sync nativo: ejecuta
bunx cap synctras actualizar los plugins. - Fuente de verdad: confianza
src/definitions.tsen el repo de GitHub.
Resumen de API
Sección titulada “Resumen de API”Cada ejemplo repite el import para que el fragmento pueda copiarse por separado.
initialize
Sección titulada “initialize”Inicializa el SDK con la URL de la cámara
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.initialize({ url: 'https://example.com' });console.log(result);getCameraAsset
Sección titulada “getCameraAsset”Obtiene un recurso de cámara desde una URL y lo devuelve en base64
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.getCameraAsset({ url: 'https://example.com' });console.log(result);listFiles
Sección titulada “listFiles”Lista los archivos almacenados en la cámara
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.listFiles();console.log(result);capturePicture
Sección titulada “capturePicture”Captura una imagen
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.capturePicture();console.log(result);captureVideo
Sección titulada “captureVideo”Captura un video
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.captureVideo({ resolution: '4K', frameRate: 1, bitrate: 1,});console.log(result);livePreview
Sección titulada “livePreview”Inicia la vista previa en vivo
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.livePreview({ displayInFront: false, cropPreview: false,});console.log(result);stopLivePreview
Sección titulada “stopLivePreview”Detiene la vista previa en vivo
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.stopLivePreview();console.log(result);readSettings
Sección titulada “readSettings”Lee la configuración de la cámara
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.readSettings({ options: ['option'] });console.log(result);setSettings
Sección titulada “setSettings”Configura los ajustes de la cámara
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.setSettings({ options: {} });console.log(result);sendCommand
Sección titulada “sendCommand”Envía un comando en bruto a la cámara
import { Ricoh360Camera } from '@capgo/capacitor-ricoh360';
const result = await Ricoh360Camera.sendCommand({ endpoint: 'https://example.com', payload: {},});console.log(result);Referencia de tipos
Sección titulada “Referencia de tipos”InitializeOptions
Sección titulada “InitializeOptions”export interface InitializeOptions { url: string;}CommandResponse
Sección titulada “CommandResponse”export interface CommandResponse { session?: string; info?: string; preview?: string; picture?: string; settings?: string;}GetCameraAssetOptions
Sección titulada “GetCameraAssetOptions”export interface GetCameraAssetOptions { url: string; saveToFile?: boolean;}GetCameraAssetResponse
Sección titulada “GetCameraAssetResponse”export interface GetCameraAssetResponse { statusCode: number; data: string; // base64 encoded data filePath?: string;}ListFilesOptions
Sección titulada “ListFilesOptions”export interface ListFilesOptions { fileType?: 'all' | 'image' | 'video'; startPosition?: number; entryCount?: number; maxThumbSize?: number; _detail?: boolean;}ListFilesResponse
Sección titulada “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
Sección titulada “VideoCaptureOptions”export interface VideoCaptureOptions { // Define any specific options needed for capturing a video resolution?: '4K' | '2K'; frameRate?: number; bitrate?: number;}LivePreviewOptions
Sección titulada “LivePreviewOptions”export interface LivePreviewOptions { displayInFront?: boolean; cropPreview?: boolean;}Fuente de verdad
Sección titulada “Fuente de verdad”Esta página se genera a partir del plugin src/definitions.ts. Vuelve a ejecutar el sync cuando el API público cambie en upstream.
Continúa desde Getting Started
Sección titulada “Continúa desde Primeros pasos”Si estás usando Primeros pasos para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, @capgo/capacitor-video-player por el detalle de implementación en @capgo/capacitor-video-player, y Uso de @capgo/capacitor-native-navigation para la capacidad nativa al usar @capgo/capacitor-native-navigation.