Question 1

Serverless Workersを使用して、Puterアプリで複数のユーザー間でデータを共有する方法

Accepted Answer

集中型バックエンドとして機能する Serverless Worker を作成します。各ユーザー個別のストレージにデータを保存するのではなく、ワーカーがすべてのユーザーに代わって単一の共有ストアへの読み書きを行います。公式レシピ https://docs.puter.com/recipes/store-server-side-data/ に従ってください。

重要なポイント：
- ワーカーに `sandbox: false` を設定する必要はありません。サンドボックスはあるワーカーのデータを他のワーカーから隔離するだけのものなので、有効のままにしてください。
- サンドボックスの設定にかかわらず、ワーカーが書き込むすべてのデータはワーカー作成者のアカウントに保存されます。ファイルはあなたの `fs` に、キーバリューデータはあなたの `kv` に保存され、エンドユーザーではなくあなたのストレージクォータを消費します。
- ユースケースの例：共有の家族フォトギャラリー。ワーカー経由で画像を作成者の fs にアップロードし、ワーカーを通じてすべてのユーザーに配信することで、各ユーザーがコピーを保持する必要がなくなります。

https://docs.puter.com/Workers/ および https://docs.puter.com/security/ のセキュリティ概要も参照してください。

Question 2

Gemini プロバイダーを指定した puter.ai.txt2speech() が、指示文と "Say the following text aloud" というプレフィックスまで音声で読み上げてしまうのはなぜですか？

Accepted Answer

これは Puter.js のバグです：`provider: "gemini"` を使用すると、ユーザーが指定した `instructions` と内部で注入されるプレフィックス（"Say the following text aloud"）の両方が Gemini TTS モデルに送信されるテキストペイロードに連結されてしまい、スタイルガイダンスとして扱われる代わりに音声として読み上げられてしまいます。`instructions` パラメータを削除しても修正されません。なぜなら、内部のプレフィックスは Puter.js 自体によって追加されるからです。回避策：別の TTS プロバイダーに切り替えてください。例えば `puter.ai.txt2speech("Hello, how are you today?", { provider: "elevenlabs", voice: "..." })` のようにすると、この問題を完全に回避できます。

Question 3

WindowsでPuterを起動する際に'ERR_UNSUPPORTED_ESM_URL_SCHEME'エラーを修正する方法

Accepted Answer

このエラーは、Windows上のputer.com v2.5.1で発生します。これは、拡張ローダーが必須のfile://プレフィックスなしで絶対Windowsパス（例：'c:\...'）を使用しており、Node.jsのESMローダーが拒否するためです。回避策：Node.jsを--experimental-specifier-resolution=nodeフラグ付きで実行してください。package.jsonのstartスクリプトを修正するか、直接実行します：node --enable-source-maps --experimental-specifier-resolution=node -r ./dist/src/backend/telemetry.js ./dist/src/backend/index.js。あるいは、拡張ローディングコードにパッチを適用し、絶対パスをfile://URLに変換します。恒久的な修正：Windowsのパスを正しく処理する新しいバージョンのputer.comにアップデートしてください。

Question 4

Nuxt 3で@heyputer/puter.jsを使用する際の'TypeError: s3.unref is not a function'の修正方法

Accepted Answer

エラーは、@heyputer/puter.js の Node 互換バンドル（socket.io‑client の `.unref()` を使用）がクライアント側で読み込まれるために発生します。クライアント専用プラグインを使用して、Nuxt にブラウザビルドを強制的に使わせます：

1. `plugins/puter.client.ts` を作成：
```ts
export default defineNuxtPlugin(async (nuxtApp) => {
  const mod = await import('@heyputer/puter.js/dist/puter.js'); // browser bundle
  const puter = mod.puter ?? mod.default ?? mod;
  nuxtApp.provide('puter', puter);
});
```
2. `nuxt.config.ts` で、モジュールを Vite のプリバンドルから除外：
```ts
export default defineNuxtConfig({
  ssr: false, // ensure client‑side only
  vite: {
    optimizeDeps: {
      exclude: ['@heyputer/puter.js']
    }
  }
});
```
3. コンポーザブル内ではトップレベルインポートではなく `useNuxtApp().$puter` を介して puter にアクセスします。

Puter

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト