@capacitor-community/volume-buttons

中文文档
8.0.1发布于 2026/07/24MITTypeScriptESM + CJS零依赖近 30 天下载 1.4万

电容 音量按钮. 插件允许收听硬件音量按钮

中文使用文档
文档目录16 节
  1. 音量按钮插件
  2. 目录
  3. 维护者
  4. 关于
  5. 插件版本
  6. 支持的平台
  7. 安装
  8. API 密码
  9. 正在观察 ()
  10. 监视卷(...)
  11. 清除监视( C)
  12. 接口
  13. 类型异名
  14. 使用量
  15. 在应用程序中添加音量按钮监听器
  16. 删除应用程序中的音量按钮监听器


音量按钮插件

@capacitor-community/volume-buttons

听取硬件音量按钮的电容社区插件


目录

维护者

维护者GitHub 图像活动
尼亚a尼亚a对

关于

此插件允许在用户按下设备的硬件音量上下键时监听所引发的事件. 仅包含一个属性的对象被转到回调 - 见 音量按钮。 。 。 . 此插件包含源自或启发的代码 https://github.com/CipherBitCorp/VolumeButtonHandler 互联网档案馆的存檔,存档日期2013-12-21 财务报告和审定财务报表 https://github.com/thiagobrez/ 电容-容量-按钮 插件 .


特征 :

  • 支持最大音量或分( 确保使用) 时接收事件 disableSystemVolumeHandler iOS 平台 - 见 音量按钮选项(中文(简体) )
  • 继续接收发送到应用程序后的事件,并从背景返回
  • 支持 Android 和 iOS 平台

页:1:插件版本8.x与Capacitor 8兼容

插件版本

电容版本插件版本
8.x 电话8.x 电话
7.x 电话7.x 电话
6.x (单位:千美元)6.x (单位:千美元)
5.x 电话1.x 运算

支持的平台

  • iOS系统
  • 机器人

安装

npm install @capacitor-community/volume-buttons
npx cap sync

API 密码

正在观察 ()

isWatching() => Promise<GetIsWatchingResult>

获取音量按钮的监视状态 .

回返情况: Promise<GetIsWatchingResult>

自: 1.0.1 (中文(简体) )


监视卷(...)

watchVolume(options: VolumeButtonsOptions, callback: VolumeButtonsCallback) => Promise<CallbackID>

为他设置手表 硬件音量按钮更改

参数类型
optionsVolumeButtonsOptions
callbackVolumeButtonsCallback

回返情况: Promise<string>

自: 1.0.0 (单位:千美元)


清除监视( C)

clearWatch() => Promise<void>

清除已有的表

自: 1.0.0 (单位:千美元)


接口

获取监视结果

Prop类型说明自兹
valueboolean如果音量按钮被监视.1.0.1 (中文(简体) )

音量按钮选项

Prop类型说明自兹
disableSystemVolumeHandlerboolean此参数可用于禁用系统音量处理器(仅iOS). 如果这是真的,当调取上下音量按钮时,系统音量将总是被重置到初始音量(启动音量按钮跟踪/上传时的音量),如果初始音量较小,则重置到0.05;如果初始音量较大,则重置到0.95.1.0.0 (单位:千美元)
suppressVolumeIndicatorboolean此参数可用于压制/隐藏系统体积指标(仅Android,它从未在iOS上显示过). 如果这是真的,当调用上下音量按钮时,系统音量指示器将不会显示. 默认值是虚假的 .1.0.2 联合国

音量按钮

Prop类型说明自兹
direction'up' | 'down'这表明按下了音量上下键.1.0.0 (单位:千美元)

类型异名

调回音量按钮

(result: VolumeButtonsResult, err?: any): void

调用回话ID

string

使用量

请参看 示例应用程序 一个完整的例子.

在应用程序中添加音量按钮监听器

import { VolumeButtons } from '@capacitor-community/volume-buttons';

const options: VolumeButtonsOptions = {};
const callback: VolumeButtonsCallback = (result: VolumeButtonsResult, err?: any) => {
  console.log('result', result);
};
if (this.platform.is('ios')) {
  options.disableSystemVolumeHandler = true;
} else if (this.platform.is('android')) {
  options.suppressVolumeIndicator = true;
}
await VolumeButtons.watchVolume(options, callback);

删除应用程序中的音量按钮监听器

import { VolumeButtons } from '@capacitor-community/volume-buttons';

await VolumeButtons.clearWatch();

版本与发布记录

@capacitor-community/volume-buttons 共发布 8 个版本,首次发布于 2024/01/08;过去 12 个月发布了 2 个版本。

版本发布日期距今
8.0.1latest2026/07/243 个月前
8.0.02026/01/289 个月前
7.0.02025/01/281.8 年前
6.0.12024/07/232 年前
6.0.02024/04/232 年前
1.0.22024/04/092 年前

关于 @capacitor-community/volume-buttons 的常见问题

@capacitor-community/volume-buttons 是什么?

电容 音量按钮. 插件允许收听硬件音量按钮

如何安装 @capacitor-community/volume-buttons?

在项目目录运行 npm install @capacitor-community/volume-buttons,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capacitor-community/volume-buttons 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capacitor-community/volume-buttons 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capacitor-community/volume-buttons 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@capacitor-community/volume-buttons 可以商用吗?

@capacitor-community/volume-buttons 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capacitor-community/volume-buttons 的下载量有多少?

根据 npm 官方下载统计,@capacitor-community/volume-buttons 在 2026/10/09 – 2026/11/07 这 30 天内被下载 13,863 次,日均约 462 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capacitor-community/volume-buttons 还在维护吗?

最新版本 8.0.1 发布于 2026/07/24(3 个月前);至今共发布 8 个版本,其中过去 12 个月发布了 2 个;首次发布于 2024/01/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。