FreeSWITCH DTMF采集实战：从RFC2833到SIP INFO的全面解析

1. 初识DTMF：电话按键背后的“摩斯密码”

如果你用过电话，不管是座机还是手机，肯定按过数字键。每次按下“1”、“2”、“*”、“#”这些键时，听筒里都会传来一个短促的“嘀”声。这个声音，就是DTMF（双音多频）信号。你可以把它想象成一种“音频摩斯密码”，每个按键都对应着两个特定频率的声音组合。比如按“1”，就是697赫兹和1209赫兹两个音调同时发出来。这个技术从上世纪60年代用到现在，依然是电话交互的基石，无论是查话费按“1”，还是银行转账输密码，都离不开它。

在传统的模拟电话时代，这个“嘀”声就是实实在在的音频，和你的说话声混在一起，通过铜线传出去。但到了今天基于IP网络的VoIP时代，事情就变得有趣了。你的按键信息，不再非得变成声音“喊”过去，它有更多“悄悄话”的传递方式。这就像以前寄信只能走邮局，现在有了快递、电子邮件甚至闪送，选择多了，但每种方式的速度、可靠性和“邮费”都不一样。

在FreeSWITCH这个强大的开源通信平台上，处理DTMF按键是核心功能之一。无论是搭建一个自动总机（IVR），让用户按“1”转销售、“2”转售后，还是实现电话会议中的密码输入、语音信箱的密码验证，都要求FreeSWITCH能准确、可靠地“听”到用户按了哪个键。如果这一步出了问题，后面的所有业务流程都会乱套。我见过不少项目，通话接通没问题，语音也清晰，但一到输入密码或者选择菜单的环节就“失灵”，用户按了键没反应，问题十有八九就出在DTMF的采集环节上。

所以，理解FreeSWITCH如何采集DTMF，以及不同采集方式（RFC2833、INBAND、SIP INFO）的“脾气秉性”，是玩转FreeSWITCH、构建稳定语音应用的基本功。接下来，我们就抛开晦涩的术语，用最直白的方式，把这三种方式的原理、配置、实战和那些年我踩过的“坑”，给你讲明白。

2. RFC2833：默认且高效的“专用快递”

在FreeSWITCH的世界里，RFC2833是处理DTMF的“默认选项”，也是最推荐的方式。你可以把它理解为一种“专用快递”服务。普通的语音数据，就像是你通话中说出的每一句话，被打包成一个个RTP（实时传输协议）包裹，在网络上飞奔。而RFC2833为DTMF按键信息开辟了一条“专属通道”，它虽然也使用RTP来传输，但它会在RTP包的头部贴上一个特殊的“标签”——Payload Type 101，并注明这个包的内容是“telephone-event”（电话事件）。

这种方式妙在哪里呢？首先，效率极高。它传输的不是按键的“声音”，而是按键的“含义”。比如你按了“5”，它不会发送模拟“5”这个键的音频波形，而是直接发送一个代表“5”的数字代码。这就像快递员不是送一箱沉重的实物，而是送一张写着“物品已签收”的电子凭证，速度快，占用资源少。其次，非常精准。一个按键事件（比如按下、松开）被清晰地定义在数据包中，避免了因网络抖动或音频压缩导致的识别错误。

在FreeSWITCH的日志里，如果你看到类似 RTP RECV DTMF 4:1440 这样的记录，恭喜你，这说明FreeSWITCH正通过RFC2833模式愉快地接收着按键。后面的“4”是按键值，“1440”是持续时间（以时间戳单位计）。那么，我们怎么在实战中使用它呢？

2.1 实战：使用play_and_get_digits采集按键

最经典的应用场景就是IVR菜单。FreeSWITCH内置了一个非常强大的App叫 play_and_get_digits。它的工作流程很直观：先给用户播放一段提示音（比如“请输入分机号，以#号结束”），然后等待用户输入，最后把收集到的数字串交给后续流程处理。

在Dialplan（拨号计划）里，你可以这样写：

<extension name="ivr_menu">
  <condition field="destination_number" expression="^5000$">
    <action application="answer"/>
    <action application="play_and_get_digits"
           data="1 10 3 7000 # /usr/local/freeswitch/sounds/en/us/callie/ivr/8000/ivr-please_enter_extension.wav /usr/local/freeswitch/sounds/en/us/callie/ivr/8000/ivr-that_was_an_invalid_entry.wav digits ^\d+$"/>
    <action application="log" data="INFO User entered digits: ${digits}"/>
    <!-- 根据 ${digits} 的值进行路由，例如转接到对应分机 -->
    <action application="bridge" data="user/${digits}"/>
  </condition>
</extension>

我来拆解一下 play_and_get_digits 那一长串参数：

• 1：最少要收集几位数字。