Getting Started

インストール

AI-Assisted セットアップを使用してプラグインをインストールすることができます。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 セットアップを使用する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

npm install @capgo/capacitor-ricoh360
npx cap sync

インポート

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

API の概要

各例では、スニペットを単独でコピーできるようにインポートを繰り返します。

initialize

SDK をカメラ URL で初期化します。

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

await Ricoh360Camera.initialize({} as InitializeOptions);

getCameraAsset

URL からカメラアセットを取得し、base64 で返します。

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

await Ricoh360Camera.getCameraAsset({} as GetCameraAssetOptions);

listFiles

リストにカメラ内のファイルを表示

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

await Ricoh360Camera.listFiles();

capturePicture

写真を撮ります

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

await Ricoh360Camera.capturePicture();

captureVideo

動画を撮ります

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

await Ricoh360Camera.captureVideo({} as VideoCaptureOptions);

livePreview

ライブプレビューを開始

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

await Ricoh360Camera.livePreview({} as LivePreviewOptions);

stopLivePreview

ライブプレビューを停止

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

await Ricoh360Camera.stopLivePreview();

readSettings

カメラの設定を読みます

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

await Ricoh360Camera.readSettings({} as { options: string[] });

setSettings

カメラの設定を設定

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

await Ricoh360Camera.setSettings({} as { options: Record<string, any> });

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 の上流で変更された場合に再度 Sync を実行してください。

「はじめから始める」の続き

Capgo を使用している場合 Getting Started native機能とメディア、インターフェイスの動作を計画するために接続する @capgo/capacitor-live-activitiesを使用する @capgo/capacitor-live-activitiesのnative機能のために @capgo/capacitor-live-activities @capgo/capacitor-live-activitiesの実装詳細のために @capgo/capacitor-video-playerを使用する @capgo/capacitor-video-playerのnative機能のために @capgo/capacitor-video-player @capgo/capacitor-video-playerの実装詳細のために、 @capgo/capacitor-native-navigationを使用する @capgo/capacitor-native-navigationのnative機能のために