porcupine

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Porcupine Wake Word

Porcupine唤醒词

Use this skill to enable hands-free wake-word activation for a voice agent. The agent listens passively for a configured keyword (e.g. "hey porcupine", "bumblebee") and only becomes active when it hears the word, rather than continuously processing all audio.

Prefer this over always-on voice sessions when power consumption, privacy, or user preference for explicit activation matters. Porcupine runs entirely on-device — no audio is ever sent to Picovoice servers.

使用此Skill可为语音Agent实现免提唤醒词激活功能。Agent会被动监听配置好的关键词（例如“hey porcupine”、“bumblebee”），仅在听到该词时才会激活，而非持续处理所有音频。

当功耗、隐私或用户偏好明确激活方式时，优先选择此方案而非始终开启的语音会话。Porcupine完全在设备端运行——音频绝不会发送至Picovoice服务器。

Setup

设置

Obtain a free access key from https://console.picovoice.ai/ and set it as

PORCUPINE_ACCESS_KEY

or configure via agent secrets.

从https://console.picovoice.ai/获取免费访问密钥，并将其设置为`PORCUPINE_ACCESS_KEY`，或通过Agent密钥进行配置。

Configuration

配置

json

{
  "voice": {
    "wakeWord": "porcupine",
    "wakeWordOptions": {
      "keywords": ["porcupine"],
      "sensitivities": [0.5]
    }
  }
}

With multiple keywords and custom sensitivity:

json

{
  "voice": {
    "wakeWord": "porcupine",
    "wakeWordOptions": {
      "keywords": ["porcupine", "bumblebee"],
      "sensitivities": [0.5, 0.7]
    }
  }
}

json

{
  "voice": {
    "wakeWord": "porcupine",
    "wakeWordOptions": {
      "keywords": ["porcupine"],
      "sensitivities": [0.5]
    }
  }
}

多关键词及自定义灵敏度配置：

json

{
  "voice": {
    "wakeWord": "porcupine",
    "wakeWordOptions": {
      "keywords": ["porcupine", "bumblebee"],
      "sensitivities": [0.5, 0.7]
    }
  }
}

Provider Rules

服务商规则

Sensitivity ranges from 0 (least sensitive, fewer false positives) to 1 (most sensitive, fewer misses). Default is 0.5 per keyword.
Built-in keyword names include:
```
porcupine
```
,
```
bumblebee
```
,
```
blueberry
```
,
```
hey google
```
,
```
ok google
```
,
```
hey siri
```
,
```
jarvis
```
,
```
alexa
```
, and others. Check the Picovoice console for the full list.
Processing is stateless and per-frame — the detector returns a keyword index or -1 for no detection.
A free Picovoice account provides a limited number of wake-word detections per month. Check usage at console.picovoice.ai.

灵敏度范围为0（最不灵敏，误报最少）至1（最灵敏，漏报最少）。每个关键词默认值为0.5。
内置关键词包括：
```
porcupine
```
、
```
bumblebee
```
、
```
blueberry
```
、
```
hey google
```
、
```
ok google
```
、
```
hey siri
```
、
```
jarvis
```
、
```
alexa
```
等。完整列表请查看Picovoice控制台。
处理为无状态且按帧进行——检测器会返回关键词索引，未检测到则返回-1。
免费Picovoice账户每月提供有限次数的唤醒词检测。可在console.picovoice.ai查看使用情况。

Examples

示例

"Start the agent only when I say 'hey porcupine'."
"Set up hands-free wake-word detection with bumblebee."
"Use two wake words at different sensitivity levels."

“仅当我说‘hey porcupine’时启动Agent。”
“使用bumblebee设置免提唤醒词检测。”
“使用两个不同灵敏度级别的唤醒词。”

Constraints

限制条件

Requires a Picovoice access key (free tier available at console.picovoice.ai).
Audio must be 16 kHz mono LINEAR16 PCM frames of exactly 512 samples.
Custom wake words (non-built-in keywords) require a paid Picovoice subscription and a compiled
```
.ppn
```
model file.
Detection happens per-frame; integrate with the VAD pipeline to avoid processing silence frames.

需要Picovoice访问密钥（可在console.picovoice.ai获取免费层级）。
音频必须为16 kHz单声道LINEAR16 PCM帧，且每帧恰好包含512个样本。
自定义唤醒词（非内置关键词）需要付费Picovoice订阅以及编译后的
```
.ppn
```
模型文件。
检测按帧进行；需与VAD流水线集成以避免处理静音帧。