Voice Orb
呈现运动球形场,其表面响应活动强度或音频输入。
适用场景
- 当界面需要以下行为时使用 Voice Orb:呈现运动球形场,其表面响应活动强度或音频输入。
安装
选择安装方式,用法示例将同步更新导入路径。
$ bunx --bun shadcn-vue@2.8.2 add https://orvui.efu.me/r/voice-orb.json
首次使用时,将安装的 src/components/orvui/styles.css 导入项目样式入口。
示例
预览
packages/vue/src/agents/voice-orb/demo.vue
<script setup lang="ts">
import { onBeforeUnmount, onMounted, ref } from "vue";
import { VoiceOrb } from "@/components/orvui/agents/voice-orb";
const activity = ref(0);
let animation: number | undefined, preference: MediaQueryList | undefined;
let alive = false;
function paint(time: number) {
if (!alive) return;
const seconds = time / 1000;
const phrase = Math.max(0, Math.sin(seconds * 0.85));
const syllable = Math.max(
0,
Math.sin(seconds * 9.3 + Math.sin(seconds * 2.1)),
);
activity.value = preference?.matches
? 0
: phrase * (0.12 + syllable * syllable * 0.72);
animation = requestAnimationFrame(paint);
}
onMounted(() => {
alive = true;
preference = matchMedia("(prefers-reduced-motion: reduce)");
animation = requestAnimationFrame(paint);
});
onBeforeUnmount(() => {
alive = false;
if (animation !== undefined) cancelAnimationFrame(animation);
});
</script>
<template>
<VoiceOrb
:activity="activity"
aria-label="Voice visualization"
class="w-64 sm:w-72"
/>
</template>
packages/vue/src/agents/voice-orb/src/VoiceOrb.vue
状态与事件
此示例组合没有声明成对的受控属性与 update 事件。使用已列出的属性、原生事件和插槽组合内容;不要为它添加未公开的 v-model。
API 参考
activity?number | MotionValue<number>0analyser?null | AnalyserNodenullcolors?readonly [string, string, string]() => ["#e8754d", "#ffe0ac", "#346b52"] as constactive?booleantruespeed?number1label?string—事件
error[error: Error]@error插槽
fallback() => VNodeChild#fallback无障碍
为交互控件提供明确的无障碍名称。保留文档中的键盘路径、可见焦点与减少动态效果状态;自定义插槽应继续保留所替代部件的语义。
常见问题
- 如何配置 Voice Orb?
- 通过 activity、analyser、colors、active、speed、label 配置 Voice Orb;API 表列出其类型与默认值。
- 如何连接到应用状态?
- 监听 error,将组件连接到应用状态。
- 可以在服务端渲染吗?
- 可以在 Vue SSR 应用中正常渲染。服务端与客户端的初始 props 应保持一致;浏览器测量与交互资源在挂载后启动。
更新于
来源与许可 ↗MIT · 0.1.1