告别繁琐！如何使用Composer和OpenTok/VonageSDK轻松构建实时视频应用

可以通过一下地址学习composer：学习地址

想象一下，你正在构建一个在线教育平台，或者一个远程医疗咨询系统，甚至是一个互动直播应用。这些场景的核心都离不开实时音视频通信。你可能会想到webrtc，它是浏览器原生的实时通信技术，功能强大。然而，webrtc仅仅是一个底层协议，要将其应用于实际项目，你还需要考虑：

• 信令（Signaling）： 如何让参与者互相发现并交换连接信息？
• 网络穿透（NAT Traversal）： 复杂的网络环境（防火墙、路由器）如何确保连接成功？这需要STUN/TURN服务器。
• 媒体路由（Media Routing）： 当参与者众多时，点对点连接效率低下，需要媒体服务器进行混流或转发。
• 录制与归档： 如何将实时会话录制下来，以便回放或审计？
• 直播推流： 如何将实时视频推送到CDN，实现大规模观众观看？
• 扩展性与稳定性： 如何保证系统在高并发下的性能和可靠性？

面对这些挑战，许多开发者往往望而却步。难道就没有一种更简单、更高效的方式来集成实时视频吗？答案是肯定的，这就是我们今天要介绍的

opentok/opentok

拥抱Composer，引入OpenTok/Vonage SDK

在PHP的世界里，Composer 已经成为依赖管理的标准。它让引入第三方库变得前所未有的简单。对于实时视频集成，TokBox（现已并入Vonage）提供的OpenTok平台是业界领先的解决方案之一，而

opentok/opentok

这个SDK将复杂的实时音视频底层逻辑封装起来，为你提供一套简洁明了的API接口，让你专注于业务逻辑，而无需深陷WebRTC的泥潭。它负责管理会话、生成令牌、处理媒体路由、提供录制和直播功能等，极大地简化了开发流程。

轻松安装，即刻上手

使用Composer安装

opentok/opentok

composer require opentok/opentok ^4.0

安装完成后，Composer会自动处理所有依赖，并生成自动加载文件。在你的项目中，只需引入Composer的自动加载文件即可开始使用：

require __DIR__ . '/vendor/autoload.php';

构建你的第一个实时视频会话

现在，让我们看看如何使用

opentok/opentok

1. 初始化OpenTok对象

首先，你需要从Vonage Video API（或TokBox）控制台获取你的API Key和API Secret。它们是访问OpenTok服务的凭证。

use OpenTok\OpenTok;

$apiKey = 'YOUR_API_KEY';    // 替换为你的API Key
$apiSecret = 'YOUR_API_SECRET'; // 替换为你的API Secret

$opentok = new OpenTok($apiKey, $apiSecret);

如果你正在从旧的TokBox平台迁移到新的Vonage Video API，并且希望使用Vonage的认证方式（Application ID和私钥），SDK也提供了平滑过渡的选项：

use OpenTok\OpenTok;

$applicationID = 'YOUR_VONAGE_APPLICATION_ID';
$privateKeyPath = './private.key'; // 私钥文件路径

$opentok = new OpenTok($applicationID, $privateKeyPath);

SDK会智能识别认证方式，并自动将请求路由到正确的API端点。

云从科技AI开放平台

云从AI开放平台

下载

2. 创建一个会话（Session）

会话是实时视频通信的“房间”。所有参与者都将连接到同一个会话中。你可以指定会话的媒体模式（点对点或路由模式，路由模式支持录制和直播），以及地理位置提示等。

use OpenTok\MediaMode;
use OpenTok\ArchiveMode;

// 创建一个使用OpenTok媒体路由器的会话（支持录制和直播）
$sessionOptions = [
    'mediaMode' => MediaMode::ROUTED,
    // 'archiveMode' => ArchiveMode::ALWAYS // 如果需要自动录制，可以开启
];
$session = $opentok->createSession($sessionOptions);

$sessionId = $session->getSessionId(); // 获取会话ID，你需要将它传递给前端
echo "会话ID: " . $sessionId;

// 将 $sessionId 存储到数据库中，以便后续使用

$sessionId

3. 生成令牌（Token）

令牌是客户端连接到会话的“入场券”。每个客户端都需要一个有效的令牌。你可以为令牌设置角色（发布者、订阅者、主持人）、过期时间以及自定义连接数据等。

use OpenTok\Role;

// 为某个用户生成一个令牌
$token = $opentok->generateToken($sessionId, [
    'role'       => Role::PUBLISHER, // 角色：发布者
    'expireTime' => time() + (60 * 60), // 令牌在一小时后过期
    'data'       => 'userId=123,username=Alice' // 自定义数据
]);

echo "用户令牌: " . $token;

// 将 $token 传递给前端，供客户端SDK使用

前端（如JavaScript SDK）会使用这个

sessionId

token

更多强大功能

opentok/opentok

• 存档（Archiving）： 轻松录制会话，支持合成录制（所有流混合成一个视频）和单流录制。
• 直播（Live Streaming）： 将OpenTok会话内容推流到RTMP服务器，实现大规模直播。
• SIP互联： 允许外部SIP电话呼入OpenTok会话，实现音视频会议与传统电话网络的融合。
• 信号（Signaling）： 在会话中发送自定义消息，实现更丰富的互动功能（如聊天、投票）。
• 强制断开连接/静音： 管理会话中的参与者，可以强制某个连接断开，或强制其静音。
• 布局控制： 动态调整合成录制或直播时的视频布局。

总结与展望

通过

opentok/opentok

使用

opentok/opentok

1. 简化复杂性： 将WebRTC的底层细节完全抽象，开发者无需关心复杂的信令、媒体路由和网络穿透问题。
2. 基础设施即服务： OpenTok平台负责所有服务器、带宽和维护，你只需调用API即可。
3. 功能全面： 从基础的视频通话到高级的录制、直播、SIP互联，一应俱全。
4. 跨平台支持： PHP SDK负责后端逻辑，前端有成熟的JavaScript、iOS、Android SDK，实现全栈覆盖。
5. 稳定可靠： 作为Vonage旗下的产品，OpenTok平台拥有强大的技术支持和高可用性保障。

告别了从零开始构建实时视频的噩梦，现在你可以将精力集中在你的核心业务逻辑上，为用户带来无缝、高质量的实时音视频体验。如果你还在为实时视频集成而烦恼，不妨立即尝试

opentok/opentok