文档

​
​

Development

User Acquisition

Monetization

工业

Vivox Unity SDK

Vivox Unity SDK

Vivox
​
​
Vivox Unity SDK
  • Overview
  • Get started
  • Release notes
  • Developer guide
    • Set up your project
    • Create voice and text channels
      • Channel management
      • Channel name criteria
      • Channel types
      • Positional channels
        • Large 3D channels setting
        • Positional channel properties
        • Positional channel configuration
      • Channel identifiers for large scale games
      • Participant management
      • Join a channel
      • Leave a channel
      • Channel webhooks
      • Automatic connection recovery
    • Messaging
    • Player management
    • Device management
    • Audio management
    • Mobile development
    • Text-to-speech
    • Speech-to-text
    • Real-time recording
    • Server-side-recording
    • Troubleshooting
  • Tutorials
  • Reference
  1. Vivox Unity SDK 文档
  2. Vivox Unity 开发者指南
  3. 频道

位置频道属性

Understand properties for positional channels in Vivox.
阅读时间2 分钟
最后更新于 8 个月前

用户在位置音频频道中的音频体验取决于
VivoxService.Instance.JoinPositionalChannelAsync
的 Channel3DProperties 组件。
以下属性在频道中控制 3D 体验。每个属性在 Channel3DProperties 类的 HTML 参考中都进行了非常详细的说明。
  • AudibleDistance
    • 监听器能够听到扬声器并接收其文本消息的距离扬声器的最大距离。
    • 默认值为 32。
  • ConversationalDistance
    • 控制扬声器音频保持其原始音量的范围,超出该范围时,语音聊天的响度在被听到时开始淡出。
    • 默认值为 1。
  • AudioFadeModel
    • 指定控制音频在
      ConversationalDistance
      与
      AudibleDistance
      之间如何淡化的形状的公式或曲线。
    • 默认值为
      AudioFadeModel.InverseByDistance
      。
  •  AudioFadeIntensityByDistance
    • 控制
      AudioFadeModel
      曲线的幅度,以便使语音聊天响度的衰减达到上限或下限。
    • 默认值为 1.0。
选择默认
Channel3DProperties
值都是为了提供适用于大多数情况的听起来最自然且逼真的 3D 音频。使用默认属性时,32 米(约 105 英尺)范围内的任何听者都可以听到发言者,1 米(约 3 英尺)范围内的任何人都能听到发言者的最大音量。
注意
默认距离值使用米,因为这是 Unity 中的默认距离测量单位,但您可以以任何比例指定这些值。
自定义距离值时,请考虑以下准则:
  • 您可以采用任何单位表示 AudibleDistance 和 ConversationalDistance,但是这两个单位必须始终匹配。值可以不同。
    注意
    使用 Set3DPosition 方法报告角色的位置时,必须使用相同的单位。
  • ConversationalDistance 是指听者能够以原始音量听到发言者语音的距离。该距离必须是处于范围 0 <= ConversationalDistance <= AudibleDistance 中的整数。可以将该距离理解为听者与发言者之间的理想对话距离。
  • 当 ConversationalDistance 是游戏中典型讲话实体的一半高度时,听起来最逼真。
    如果玩家比普通成年人矮或高,则考虑调整此值,以便进行匹配。
  • 当使用默认 AudioFadeModel 值时,如果要使语音聊天在 AudibleDistance 边缘自然淡入或淡出至接近零响度,以便使其听起来不像是被突然中断,则将 AudibleDistance 设置为最小值:
    32 × ConversationalDistance ÷ AudioFadeIntensityByDistance。
    如果想要更低的最大 AudibleDistance(例如用于限制接收文本的范围),可相应地增加 AudioFadeIntensityByDistance。
    根据环境游戏噪声或音乐的音量,可能想要进一步调整这些值,以确保仅在想要的距离可听到语音聊天。
  • 当使用 ExponentialByDistance AudioFadeModel 时,建议使 ConversationalDistance 值保持在 1 或更大。
  • 当使用 ExponentialByDistance AudioFadeModel 时,建议根据以下公式调整 AudioFadeIntensityByDistance 属性的值:
    AudioFadeIntensityByDistance = 3 ÷ (1 + 1.75 × log10(ConversationalDistance))

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。


    报告此页面的问题