跳转至正文
@capgo/capacitor-ricoh360 已重命名 已从 @capgo/ricoh360 重命名为 @capgo/capacitor-ricoh360. 媒体 开源

Ricoh360 相机 Capacitor 插件

控制 Ricoh Theta 360 度相机,拍摄沉浸式全景照片

安装

bun add @capgo/capacitor-ricoh360 bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-ricoh360
  • pnpm add @capgo/capacitor-ricoh360
  • yarn add @capgo/capacitor-ricoh360

指南

如何在 Capacitor 中使用 Ricoh360 Camera

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Ricoh360 Camera plugin 预览二维码 code

使用 @capgo/capacitor-ricoh360

为 Ricoh360 相机提供适用于 Capacitor 的 SDK。

安装

npm install @capgo/capacitor-ricoh360
npx cap sync

插件暴露的内容

  • initialize - 使用相机 URL 初始化 SDK。
  • getCameraAsset - 从 URL 获取相机资源并以 base64 格式返回。
  • listFiles - 列出相机中存储的文件。
  • capturePicture - 拍摄照片。

用法示例

initialize

使用相机 URL 初始化 SDK。

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

const result = await Ricoh360Camera.initialize({ url: 'https://example.com' });
console.log(result);

getCameraAsset

从 URL 获取相机资源并以 base64 返回。

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

const result = await Ricoh360Camera.getCameraAsset({ url: 'https://example.com' });
console.log(result);

listFiles

列出相机中存储的文件。

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

const result = await Ricoh360Camera.listFiles();
console.log(result);

capturePicture

拍摄照片。

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

const result = await Ricoh360Camera.capturePicture();
console.log(result);

完整参考

从“使用 @capgo/capacitor-ricoh360”继续

如果你正在使用 @capgo/capacitor-ricoh360 来规划原生媒体和界面行为,并将其与 使用 @capgo/capacitor-live-activities 用于使用 @capgo/capacitor-live-activities 时的原生能力, @capgo/capacitor-live-activities 在 @capgo/capacitor-live-activities 中的实现细节, 使用 @capgo/capacitor-video-player 用于使用 @capgo/capacitor-video-player 时的原生能力, @capgo/capacitor-video-player 在 @capgo/capacitor-video-player 中的实现细节,以及 使用 @capgo/capacitor-native-navigation 用于使用 @capgo/capacitor-native-navigation. 时的原生能力

常见问题

Ricoh360 Camera 插件常见问题

如何在 Capacitor 应用中安装 Ricoh360 Camera 插件?

运行 "bun add @capgo/capacitor-ricoh360"(或 "npm install @capgo/capacitor-ricoh360"),然后运行 "bunx cap sync",以便 iOS 和 Android 项目获取原生 code。在您的应用 code 中从 "@capgo/capacitor-ricoh360" 导入它。

@capgo/capacitor-ricoh360 支持 React、Vue 和 Angular 吗?

是的。Ricoh360 Camera 是一个 Capacitor 包,因此它适用于任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-ricoh360 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-ricoh360 是免费且开源的吗?

是的。code 源代码公开在 GitHub 上,地址为 https://github.com/Cap-go/capacitor-ricoh360-camera-plugin/,并且可以从 npm 免费安装该包。欢迎提交 Bug 报告和 Pull Request。

我可以在不经过 App Store 审核的情况下更新使用 Ricoh360 Camera 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核,即可上线 Ricoh360 Camera 的改动

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo