Skip to content

Latest commit

 

History

History
138 lines (102 loc) · 5.64 KB

README.ja.md

File metadata and controls

138 lines (102 loc) · 5.64 KB

Wake Me

LLAMI ロゴ

手拍子やフィンガースナップを検出する AI ベースの Browser コンポーネントライブラリです。TensorFlow.js ベースの機械学習モデルを使用して、リアルタイムで正確に音を分析します。

このプロジェクトはLLAMI Teamが提供しています。

他の言語で読む: English, 한국어

オンラインデモ

ブラウザで直接体験してみましょう: オンラインデモ

⚠️ オーディオ環境の推奨事項:

  • 最良の結果を得るために、外部スピーカーとマイクの使用を推奨します
  • イヤホン/イヤポッドの使用時は正常に動作しない可能性があります
  • デスクトップとモバイル端末の両方で利用可能です！

ユースケース

  • 🎙️ 音声認識 AI システム: 手拍子やスナップで AI を起動するウェイクワードの代替として
  • 🎮 ゲームコントロール: ハンズフリーゲームシナリオでの音声インタラクション
  • 🎭 インタラクティブプレゼンテーション: プレゼンテーション中のスライド遷移やアニメーションのトリガー
  • 🖥️ ビデオ会議アシスタント: 発言順番や注目を集めるための合図
  • 🎨 デジタルアートインスタレーション: 観客とアート作品のインタラクションインターフェース
  • 👥 アクセシビリティ向上: 身体的制限のあるユーザーのための代替入力方法
  • 🤖 スマートホームコントロール: IoT デバイス制御のためのシンプルなトリガー方法
  • 📱 モバイルアプリコントロール: 手が使えない状況でのアプリ制御

主な機能

  • 🤖 TensorFlow.js を活用した高性能 AI モデル
  • ⚡ リアルタイムの音声検出と分析
  • 🎯 高精度な手拍子/スナップ認識
  • 🪶 軽量で使いやすい

インストール

npm install wake-me
# または
yarn add wake-me

使用方法

import { WakeMe } from "wake-me";

function App() {
  return <WakeMe onSnap={() => console.log("スナップを検出しました！")} />;
}

Next.js での使用

Next.js プロジェクトで Wake Me を使用する場合、必要なスクリプトとモデルファイルを直接組み込む必要があります：

  1. publicディレクトリにモデルファイルをコピーします。
  2. スクリプト URL を CDN から指定します:
import { WakeMe } from "wake-me";

function App() {
  return (
    <WakeMe
      tfScriptUrl="https://cdn.jsdelivr.net/npm/@tensorflow/tfjs/dist/tf.min.js"
      speechCommandsScriptUrl="https://cdn.jsdelivr.net/npm/@tensorflow-models/speech-commands/dist/speech-commands.min.js"
      modelBaseUrl="/snap/"
      onSnap={() => console.log("スナップを検出しました！")}
    />
  );
}

フレームワークサポート

WakeMe はフレームワークに依存しないように設計されています！React コンポーネントとして提供されていますが、以下の環境でも使用できます：

  • React
  • バニラ JavaScript
  • Angular
  • Vue.js
  • その他すべての JavaScript フレームワーク

React での使用方法

import { WakeMe } from "wake-me";

function App() {
  return <WakeMe onSnap={() => console.log("スナップを検出しました！")} />;
}

バニラ JavaScript での使用方法

<script src="https://cdn.jsdelivr.net/npm/wake-me@latest/dist/vanilla/vanilla.global.js"></script>
<script>
  const wakeMe = new WakeMe({
    onSnap: () => {
      // スナップイベントの処理
      console.log("スナップ！");
    },
    onNoise: (score) => {
      // ノイズレベルの処理
      console.log("ノイズレベル:", score);
    },
  });

  // 検出開始
  wakeMe.init();

  // 使用終了時のクリーンアップ
  // wakeMe.destroy();
</script>

プロパティ

プロパティ名 型 必須 説明
onSnap () => void はい スナップ音が検出された時に呼び出されるコールバック関数
onNoise (score: number) => void いいえ ノイズが検出された時に呼び出されるコールバック関数
tfScriptUrl string いいえ TensorFlow.js スクリプトの URL
speechCommandsScriptUrl string いいえ Speech Commands スクリプトの URL
modelBaseUrl string いいえ カスタムモデルのベース URL
snapThreshold number いいえ 検出感度のしきい値（デフォルト: 0.95）。検出が不十分な場合は 0.9 に下げることができます

ライセンス

MIT ライセンスの下で公開されています。詳細はLICENSEファイルをご覧ください。