保姆级教程,集成七牛云SDK实现Web端音视频通话
创始人
2025-06-01 08:50:34

😄作者简介:
小曾同学.com,一个致力于测试开发的博主⛽️,主要职责:测试开发、CI/CD,偶尔跟着开发学习音视频知识,希望输出的内容可以帮助和我一样初入职场,经验不足的小白。
😊 座右铭:不想当开发的测试,不是一个好测试✌️。
如果感觉博主的文章还不错的话,记得点赞、收藏哦!👍

如果你有一个实现”1v1视频通话“的场景需求,如果你想入门音视频,不妨来看看这篇文章。本文将介绍如何通过少量的代码集成七牛音视频SDK,实现高质量、低延迟的视频通话Web应用。

文章目录

  • 一 前言
  • 二 前期准备
  • 三 实战环节
    • 3.1 创建Web项目
    • 3.2 实现音视频通话
    • 3.3 Demo展示
  • 四 小结

一 前言

在开始实践之前,有必要提前简单介绍一下七牛的 RTC SDK。它提供了功能丰富的各端SDK,目前QRTC有新旧两套版本并行:

新版本:4.x及之后的版本

旧版本:3.x及之前的版本

如果接入的话,web 端推荐使用4.x版本,其他端使用5.x版本。另外在实现过程中需要用到APPidtoken信息,所以在接入 SDK 之前需要先了解下接入流程,完成对应认证信息,获取对应Appidtoken信息,而且每月有2万分钟免费额度。如果你是学习/调试,这些分钟完全够用。

二 前期准备

本篇文章主要是集成七牛云 SDK 实现 Web 端音视频通话,那么需要有以下准备:

  • 七牛云 Appid、临时Token(具体注册流程可查看这里),注册完毕后创建一个应用,即可获取appid。

    在这里插入图片描述

    再通过appid ,点击生成 RoomToken 来获取 临时token

    在这里插入图片描述

  • 七牛Web SDK:获取最新SDK可在这里获取(web端 SDK对应的是一个js文件)。

小编开发及测试环境如下:

  • Visual Studio code:v1.76.2
  • 七牛Web SDK:v4.2.0
  • Google Chrome:v111.0.5563.64

三 实战环节

基于【前期准备】已经获取了七牛,本节主要介绍 Web 端如何集成七牛云RTC SDK,实现1V1视频通话。

3.1 创建Web项目

创建一个名为 VideoCallDemo 的文件夹。一个Web客户端项目至少需包含以下文件:

index.html :主要用于设计Web应用的用户界面。

VideoCall.js: 主要通过 QNRTCClient实现具体应用逻辑的代码。

qnweb.js : 引入Web端RTC SDK。(将官方提供的Web SDK的内容拷贝至该文件内。)

3.2 实现音视频通话

(1)引入SDK

index.html 文件中引入SDK


(2)设计客户端用户页面


One on One Sample 

本地视频

远端视频

(3)实现音视频通话逻辑

VideoCall.js文件中实现逻辑音视频通话逻辑代码

通过调用createClient()方法创建QNRTCClient对象。当用户点击加房时,通过调用join方法加入RTC房间,并在方法中传入roomtoken参数,再调用createMicrophoneAndCameraTracks()方法采集音视频,该方法会返回音频轨和视频轨对象,并调用publish()方法将音视频 track发布到房间,再通过play()方法播放音视频 track。

async function joinRoom() {// 创建QNRTCClient对象const client = QNRTC.createClient();// 需要先监听对应事件再加入房间autoSubscribe(client);const roomTokenInput = document.getElementById("roomtoken");const roomToken = roomTokenInput.value;await client.join(roomToken);await publish(client);
}async function publish(client) {// 返回一组audio track 与 video trackconst localTracks = await QNRTC.createMicrophoneAndCameraTracks();await client.publish(localTracks);// 获取页面上的一个元素作为播放画面的父元素const localElement = document.getElementById("localtracks");// 遍历本地采集的 Track 对象for (const localTrack of localTracks) {console.log(localTrack)// 如果这是麦克风采集的音频 Track,我们就不播放它。if (localTrack.isAudio()) continue;// 调用 Track 对象的 play 方法在这个元素下播放视频轨localTrack.play(localElement, {mirror: true});}
}

(3)订阅远端音视频track

通过subscribe函数实现订阅远端音视频功能,并在预设的位置中播放音视频。

async function subscribe(client, tracks) {
// 传入 Track 对象数组调用订阅方法发起订阅,异步返回成功订阅的 Track 对象。const remoteTracks = await client.subscribe(tracks);const remoteElement = document.getElementById("remotetracks");// 遍历返回的远端 Track,调用 play 方法完成在页面上的播放for (const remoteTrack of [...remoteTracks.videoTracks, ...remoteTracks.audioTracks]) {remoteTrack.play(remoteElement);}
}

(4)添加事件监听

通过autoSubscribe函数实现实时检测房间的 Track变化并在合适的时机调用 subscribe

function autoSubscribe(client) {// 添加事件监听,当房间中出现新的 Track 时就会触发,参数是 trackInfo 列表client.on("user-published", (userId,tracks) => {subscribe(client, tracks).then(() => console.log("subscribe success!")).catch(e => console.error("subscribe error", e));});
}

至此,音视频通话简易demo已完成,可以尝试运行查看效果

(5)浏览器兼容性检测

并不是所有的浏览器都支持webRTC,可以通过checkSystemRequirements()方法检测浏览器兼容性,该方法,会自动检测媒体流采集、加入房间、发布、订阅、离开房间等整个流程。在VideoCall.js文件实现checkSystem()函数。

async function checkSystem(){const result = await QNRTC.checkSystemRequirements();if (result.ok) {console.log("test ok!");} else {console.log("test fail", result.reason);}
}

并在index.html文件中增加对应 button 进行函数调用。

3.3 Demo展示

如果你也是使用的VSCode IDE ,不妨下载Live Server插件,之后在html文件中右击选择Open with Live Server即可运行网页。demo运行地址为 http://127.0.0.1:5502/index.html

在这里插入图片描述

当用户点击checkSystem 按钮时,可以在控制台过滤“test ok! ”查看检测信息。

当点击加入房间时,客户端开始采集麦克风和摄像头并进行发布,同时当远端用户加入时,会实时监测并订阅远端音视频 track。至此,音视频通话demo实现完毕。

在这里插入图片描述

四 小结

本文详细介绍了web平台如何集成七牛云SDK,实现音视频通话。通过少量代码,实现简易音视频Demo,如果你想实现更复杂的场景,可以参考七牛官网API。行文仓促,认识有限,欢迎讨论拍砖。

相关内容

热门资讯

(今日资讯)“新版wepoke... 您好:新版wepoker这款游戏可以开挂,确实是有挂的,需要了解加客服微信【5848499】很多玩家...
今日重大通报“中至窝龙究竟有没... 您好:中至窝龙这款游戏可以开挂,确实是有挂的,需要软件加微信【69174242】,很多玩家在中至窝龙...
玩家必看“打两圈泰州麻将究竟有... 亲.打两圈泰州麻将这款游戏是可以开挂的,确实是有挂的,通过添加客服【3671900】很多玩家在这款游...
实测分享"河南推倒胡... 您好:这款游戏可以开挂,确实是有挂的,需要了解加客服微信【64550492】很多玩家在这款游戏中打牌...
重磅揭秘“ 欢乐达人能开挂吗”... 您好:欢乐达人这款游戏可以开挂,确实是有挂的,需要软件加微信【6617969】很多玩家在这款游戏中打...