Erste Schritte mit Ricoh 360° Camera

Installation

npm

npm install @capgo/capacitor-ricoh360-camera
npx cap sync

yarn

yarn add @capgo/capacitor-ricoh360-camera
npx cap sync

pnpm

pnpm add @capgo/capacitor-ricoh360-camera
npx cap sync

bun

bun add @capgo/capacitor-ricoh360-camera
npx cap sync

Plattformkonfiguration

iOS

Fügen Sie Kamera- und Fotobibliotheksberechtigungen zu Ihrer Info.plist hinzu:

<key>NSCameraUsageDescription</key>
<string>Diese App benötigt Zugriff auf die Kamera, um 360°-Fotos und Videos aufzunehmen</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>Diese App benötigt Zugriff zum Speichern von 360°-Fotos und Videos in Ihrer Bibliothek</string>

Android

Fügen Sie erforderliche Berechtigungen zu Ihrer AndroidManifest.xml hinzu:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

Unterstützte Geräte

Dieses Plugin unterstützt Ricoh Theta-Kameras:

• Ricoh Theta V
• Ricoh Theta Z1
• Ricoh Theta SC2
• Ricoh Theta X

Verwendungsbeispiel

import { Ricoh360Camera } from '@capgo/capacitor-ricoh360-camera';

// Kameraverbindung initialisieren
await Ricoh360Camera.initialize();

// Mit Ricoh Theta-Kamera über WiFi verbinden
await Ricoh360Camera.connect({
  ssid: 'THETAYL12345678',
  password: '12345678'
});

// Live-Vorschau starten
await Ricoh360Camera.startPreview({
  container: 'preview-container' // ID des HTML-Elements
});

// 360°-Foto aufnehmen
const result = await Ricoh360Camera.capturePhoto();
console.log('Foto gespeichert:', result.filePath);

// 360°-Video aufnehmen starten
await Ricoh360Camera.startRecording();

// Nach einiger Zeit Aufnahme beenden
setTimeout(async () => {
  const video = await Ricoh360Camera.stopRecording();
  console.log('Video gespeichert:', video.filePath);
}, 10000);

// Vorschau beenden
await Ricoh360Camera.stopPreview();

// Von Kamera trennen
await Ricoh360Camera.disconnect();

API-Referenz

initialize()

initialize() => Promise<void>

Initialisieren Sie das Kamera-Plugin.

connect(options)

connect(options: ConnectOptions) => Promise<void>

Verbinden Sie sich mit einer Ricoh Theta-Kamera über WiFi.

Parameter	Typ
options	ConnectOptions

disconnect()

disconnect() => Promise<void>

Trennen Sie sich von der Kamera.

startPreview(options)

startPreview(options: PreviewOptions) => Promise<void>

Starten Sie den Live-360°-Vorschau-Stream.

Parameter	Typ
options	PreviewOptions

stopPreview()

stopPreview() => Promise<void>

Beenden Sie den Live-Vorschau-Stream.

capturePhoto(options?)

capturePhoto(options?: CaptureOptions) => Promise<CaptureResult>

Nehmen Sie ein 360°-Foto auf.

Parameter	Typ
options	CaptureOptions (optional)

Rückgabe: Promise<CaptureResult>

startRecording(options?)

startRecording(options?: RecordingOptions) => Promise<void>

Starten Sie die Aufnahme von 360°-Video.

Parameter	Typ
options	RecordingOptions (optional)

stopRecording()

stopRecording() => Promise<CaptureResult>

Beenden Sie die Videoaufnahme.

Rückgabe: Promise<CaptureResult>

getCameraInfo()

getCameraInfo() => Promise<CameraInfo>

Erhalten Sie Kamerainformationen und -funktionen.

Rückgabe: Promise<CameraInfo>

setExposure(options)

setExposure(options: ExposureOptions) => Promise<void>

Legen Sie Kamerabelichtungseinstellungen fest.

Parameter	Typ
options	ExposureOptions

setWhiteBalance(options)

setWhiteBalance(options: WhiteBalanceOptions) => Promise<void>

Legen Sie den Weißabgleichsmodus fest.

Parameter	Typ
options	WhiteBalanceOptions

Schnittstellen

ConnectOptions

Eigenschaft	Typ	Beschreibung
ssid	string	WiFi SSID der Ricoh-Kamera
password	string	WiFi-Passwort der Kamera

PreviewOptions

Eigenschaft	Typ	Beschreibung
container	string	HTML-Element-ID für Preview-Container

CaptureOptions

Eigenschaft	Typ	Beschreibung
quality	number	Bildqualität (1-100) (optional)
saveToGallery	boolean	In Gerätegalerie speichern (optional)

RecordingOptions

Eigenschaft	Typ	Beschreibung
maxDuration	number	Maximale Aufnahmedauer in Sekunden (optional)
quality	string	Videoqualität: ‘high’ | ‘medium’ | ‘low’ (optional)

CaptureResult

Eigenschaft	Typ	Beschreibung
filePath	string	Pfad zur aufgenommenen Datei
fileUrl	string	URL zum Zugriff auf die Datei

CameraInfo

Eigenschaft	Typ	Beschreibung
model	string	Kameramodellname
serialNumber	string	Kameraserien nummer
firmwareVersion	string	Firmware-Version
batteryLevel	number	Akkustand (0-100)

ExposureOptions

Eigenschaft	Typ	Beschreibung
mode	string	Belichtungsmodus: ‘auto’ | ‘manual’ | ‘iso’
iso	number	ISO-Wert (100, 200, 400, etc.) (optional)
shutter	number	Verschlussgeschwindigkeit (optional)

WhiteBalanceOptions

Eigenschaft	Typ	Beschreibung
mode	string	Weißabgleich: ‘auto’ | ‘daylight’ | ‘cloudy’ | ‘tungsten’ | ‘fluorescent’

Vollständiges Beispiel

import { Ricoh360Camera } from '@capgo/capacitor-ricoh360-camera';

class Camera360Controller {
  async setup() {
    try {
      // Initialisieren
      await Ricoh360Camera.initialize();

      // Mit Kamera verbinden
      await Ricoh360Camera.connect({
        ssid: 'THETAYL12345678',
        password: '12345678'
      });

      // Kamerainformationen abrufen
      const info = await Ricoh360Camera.getCameraInfo();
      console.log('Verbunden mit:', info.model);
      console.log('Akkustand:', info.batteryLevel + '%');

      // Belichtung konfigurieren
      await Ricoh360Camera.setExposure({
        mode: 'auto'
      });

      // Weißabgleich konfigurieren
      await Ricoh360Camera.setWhiteBalance({
        mode: 'auto'
      });

      // Vorschau starten
      await Ricoh360Camera.startPreview({
        container: 'camera-preview'
      });

    } catch (error) {
      console.error('Kamerasetup fehlgeschlagen:', error);
    }
  }

  async takePhoto() {
    try {
      const result = await Ricoh360Camera.capturePhoto({
        quality: 95,
        saveToGallery: true
      });
      console.log('Foto aufgenommen:', result.filePath);
      return result;
    } catch (error) {
      console.error('Fotoaufnahme fehlgeschlagen:', error);
    }
  }

  async recordVideo(durationSeconds: number) {
    try {
      // Aufnahme starten
      await Ricoh360Camera.startRecording({
        maxDuration: durationSeconds,
        quality: 'high'
      });

      console.log('Aufnahme gestartet...');

      // Nach Dauer beenden
      setTimeout(async () => {
        const result = await Ricoh360Camera.stopRecording();
        console.log('Video gespeichert:', result.filePath);
      }, durationSeconds * 1000);

    } catch (error) {
      console.error('Videoaufnahme fehlgeschlagen:', error);
    }
  }

  async cleanup() {
    try {
      await Ricoh360Camera.stopPreview();
      await Ricoh360Camera.disconnect();
      console.log('Kamera getrennt');
    } catch (error) {
      console.error('Aufräumen fehlgeschlagen:', error);
    }
  }
}

// Verwendung
const camera = new Camera360Controller();
await camera.setup();
await camera.takePhoto();
await camera.recordVideo(10); // 10 Sekunden
await camera.cleanup();

Bewährte Methoden

• Initialisieren Sie das Plugin immer vor der Verbindung mit der Kamera
• Stellen Sie sicher, dass das Gerät mit dem WiFi-Netzwerk der Kamera verbunden ist
• Behandeln Sie Fehler elegant, besonders Verbindungsfehler
• Stoppen Sie die Vorschau und trennen Sie die Verbindung, wenn Sie fertig sind, um Akku zu sparen
• Überprüfen Sie den Kameraakku vor längeren Aufnahmesitzungen
• Testen Sie mit echter Ricoh Theta Hardware
• Verwenden Sie entsprechende Videoqualität basierend auf Speicherbeschränkungen

Fehlerbehebung

Verbindungsprobleme

• Überprüfen Sie, ob die Kamera eingeschaltet ist
• Überprüfen Sie, ob WiFi-SSID und Passwort korrekt sind
• Stellen Sie sicher, dass keine andere App mit der Kamera verbunden ist
• Setzen Sie WiFi-Einstellungen der Kamera zurück, wenn die Verbindung fehlschlägt

Vorschau wird nicht angezeigt

• Überprüfen Sie, ob das HTML-Container-Element vorhanden ist
• Überprüfen Sie, ob Kameraberechtigungen erteilt wurden
• Stellen Sie sicher, dass die Vorschau nach erfolgreicher Verbindung gestartet wird

Aufnahmefehler

• Überprüfen Sie den verfügbaren Speicherplatz
• Überprüfen Sie, ob der Kameraakku ausreichend ist
• Stellen Sie sicher, dass die Kamera nicht im Schlafmodus ist