
在 twilio 中,直接通过更新单个呼叫腿(call sid)来改变其目标 url,通常会导致当前通话的另一方被意外挂断。这是因为 twilio 默认将这种更新视为该呼叫腿的路由终结,而另一方不再有连接目标。为了实现通话保持功能,即在一方被保持时,另一方仍能保持连接或等待,我们需要采用更高级的策略。twilio 提供了两种主要方法来解决此问题:利用会议功能和管理独立呼叫腿。
使用 Twilio 会议(Conference)功能是实现通话保持和恢复最简单、最推荐的方式。会议功能天然支持多方通话管理,包括对特定参与者进行保持操作。
当通话中的一方作为会议参与者时,可以通过更新该参与者的资源来将其置于保持状态。这需要指定 hold 参数为 True,并提供一个 holdUrl 来播放保持音乐或提示音。
实现步骤:
示例代码(PHP):
<?php
// 假设已通过 Composer 引入 Twilio SDK
require_once 'vendor/autoload.php';
use Twilio\Rest\Client;
// 您的 Twilio Account SID 和 Auth Token
$sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 替换为您的 Account SID
$token = "your_auth_token"; // 替换为您的 Auth Token
$client = new Client($sid, $token);
// 假设您已有一个会议 SID 和一个参与者 SID
$conferenceSid = "CFXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 替换为您的会议 SID
$participantSid = "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 替换为要保持的参与者 SID
try {
$participant = $client
->conferences($conferenceSid)
->participants($participantSid)
->update([
"hold" => true,
"holdUrl" => "http://www.myapp.com/hold_music.xml" // 替换为您的保持音乐 TwiML URL
]);
echo "参与者 " . $participant->callSid . " 已被保持。\n";
} catch (Exception $e) {
echo "保持通话失败: " . $e->getMessage() . "\n";
}
// 示例 hold_music.xml 内容 (位于 http://www.myapp.com/hold_music.xml)
/*
<Response>
<Play loop="0">http://demo.twilio.com/docs/voice.xml</Play> // 播放示例音乐
</Response>
*/
?>注意事项:
要将通话从保持状态恢复,只需再次更新该会议参与者,并将 hold 参数设置为 False。
实现步骤:
示例代码(PHP):
<?php
// ... (与上述保持通话相同的初始化代码) ...
try {
$participant = $client
->conferences($conferenceSid)
->participants($participantSid)
->update([
"hold" => false
]);
echo "参与者 " . $participant->callSid . " 已恢复通话。\n";
} catch (Exception $e) {
echo "恢复通话失败: " . $e->getMessage() . "\n";
}
?>优点:
如果您的应用场景不适合使用会议功能,或者需要对每个呼叫腿进行更精细的控制,可以通过 TwiML 指令来管理独立呼叫腿的保持状态。然而,这种方法比使用会议功能复杂得多,需要开发者手动处理呼叫腿的路由和重连逻辑。
当您直接更新一个呼叫腿(例如,将 A 腿重定向到保持音乐),与 A 腿连接的另一条腿(B 腿)会因为 A 腿的 <Dial> 完成而挂断。为了避免这种情况,需要确保 B 腿在 A 腿被保持后,仍有后续的 TwiML 指令来保持其活跃状态。
示例 TwiML 结构:
<Response> <Dial>+CUSTOMER_NUMBER</Dial> <!-- 初始拨号 --> <Redirect>https://example.com/hold_for_other_leg</Redirect> <!-- 如果Dial完成,B腿去向 --> </Response>
在上述 TwiML 中,如果 +CUSTOMER_NUMBER 对应的呼叫腿被保持(例如,通过更新其 TwiML 指向保持音乐),则 <Dial> 动作会完成,呼叫流程会继续执行 <Redirect> 到 https://example.com/hold_for_other_leg。这个 URL 返回的 TwiML 应该让 B 腿保持活跃,例如播放等待音乐。
对于独立呼叫腿的保持,一个更健壮的方法是利用 <Enqueue> 将呼叫腿放入一个队列。
实现步骤:
示例 TwiML (用于被保持的呼叫腿 A):
<!-- 当需要保持呼叫腿 A 时,更新其 Call URL 指向此 TwiML --> <Response> <Enqueue waitUrl="http://www.myapp.com/hold_music_for_queue.xml">HoldQueue</Enqueue> </Response>
恢复独立呼叫腿的通话,意味着需要重新连接这两个呼叫腿。如果使用了 <Enqueue>,那么恢复操作通常涉及让另一条腿 <Dial> 进入相同的队列。
实现步骤:
示例 TwiML (用于恢复呼叫腿 B):
<!-- 当需要恢复通话时,更新呼叫腿 B 的 Call URL 指向此 TwiML --> <Response> <Dial><Queue>HoldQueue</Queue></Dial> </Response>
当 B 腿拨入 "HoldQueue" 时,Twilio 会自动将 B 腿与队列中等待的 A 腿连接起来,从而实现通话的恢复。
注意事项:
选择合适的策略取决于您的具体需求和对复杂性的接受程度。对于典型的客服或转接场景,会议功能无疑是更高效、更可靠的解决方案。
以上就是Twilio 语音通话保持与恢复:会议功能与独立呼叫腿管理实践的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号