{"version":"0.4.18","data":{"0":{"ops":[{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"本文介绍如何集成火山引擎 RTC SDK，并实现实时音视频通话。根据如下步骤操作，即可从 0 开始构建一个简单的音视频通话应用。\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"你也可以参考"},{"attributes":{"hyperlink":"{\"href\":\"https://github.com/volcengine/VolcEngineRTC/tree/main\",\"linkId\":\"KodjDFMFas\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"示例项目"},{"insert":"，了解更完整的项目实现。\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#.5YmN5o-Q5p2h5Lu2"},"insert":"*"},{"insert":"前提条件\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"在开始集成 RTC SDK 前，请确保满足以下要求：\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"macOS 10.13 或以上版本设备，且可以正常访问互联网\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"Qt 5.15 或以上版本，详细操作参看"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/1152682#%E5%A6%82%E4%BD%95%E5%9C%A8-macos-%E4%B8%8A%E5%AE%89%E8%A3%85-qt%EF%BC%9F\",\"linkId\":\"g4wHM3SbhE\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"如何在 macOS 上安装 Qt？"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"Xcode 13 或以上版本\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"麦克风、摄像头等音视频设备\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/75707#.5LiL6L29LXNkaw==\",\"linkId\":\"mSXmYoZSZu\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"火山引擎 RTC SDK"},{"insert":" 文件，根据你的设备情况选择 x86 或 ARM 架构版本\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"在"},{"attributes":{"hyperlink":"{\"href\":\"https://console.volcengine.com/auth/login/\",\"linkId\":\"h3aBxbrjOP\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"火山引擎控制台"},{"insert":"上"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/69865\",\"linkId\":\"Z6ySgjDqbJ\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"开通实时音视频服务"},{"insert":"，你需要从控制台获取 AppID 和临时 Token 用于项目跑通\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#.5Yib5bu66aG555uu"},"insert":"*"},{"insert":"创建项目\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"打开 Qt 安装路径下的 Qt Creator。\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"insert":"单击"},{"attributes":{"bold":"true"},"insert":"文件"},{"insert":" > "},{"attributes":{"bold":"true"},"insert":"New Project"},{"insert":"。\n"},{"attributes":{"lmkr":"1","list":"indent1","text-indent":"true"},"insert":"*"},{"attributes":{"alt":"图片","image":"true","src":"https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_790d19c41d98518d033df1de5a711a0f.png","uuid":"QXYK5CjBGJ","width":"500","loadingStatus":"success"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number1","start":"3","origin-start":"3"},"insert":"*"},{"insert":"选择 "},{"attributes":{"bold":"true"},"insert":"Qt Widgets Application"},{"insert":" 模版，输入项目名称 "},{"attributes":{"bold":"true"},"insert":"RTCTest"},{"insert":"，选择 "},{"attributes":{"bold":"true"},"insert":"qmake"},{"insert":" 构建，类名无需修改，选择自己安装的构建套件，单击"},{"attributes":{"bold":"true"},"insert":"完成"},{"insert":"。\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#.5byV5YWlLXNkaw=="},"insert":"*"},{"insert":"引入 SDK\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"根据你的设备情况"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/75707#.5LiL6L29LXNkaw==\",\"linkId\":\"lM6wkn0alJ\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"下载 x86 或 ARM 架构版本的 RTC SDK"},{"insert":"，解压后将 RTC SDK 文件夹拷贝到工程目录中，与 "},{"attributes":{"inlineCode":"true"},"insert":"RTCTest.pro"},{"insert":" 同级，并将其重命名为 VolcEngineRTC，完成后的项目目录结构如下：\n"},{"attributes":{"type":"codeblock","zoneId":"sFtJXDeeMg","language":"Plain","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#.6YWN572u6aG555uu5bGe5oCn"},"insert":"*"},{"insert":"配置项目属性\n"},{"attributes":{"lmkr":"1","list":"number1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"修改工程配置，打开 "},{"attributes":{"inlineCode":"true"},"insert":"RTCTest.pro"},{"insert":" 并在文件中添加如下内容：\n"},{"attributes":{"lmkr":"1","list":"indent1","text-indent":"true"},"insert":"*"},{"attributes":{"type":"codeblock","zoneId":"lKBXNhPFYN","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"number1","start":"2","origin-start":"2"},"insert":"*"},{"insert":"在 "},{"attributes":{"inlineCode":"true"},"insert":"RTCTest.pro"},{"insert":" 同级目录下新建 "},{"attributes":{"inlineCode":"true"},"insert":"Info.plist"},{"insert":"，并用 Xcode 打开，分别添加麦克风和摄像头权限。\n"},{"attributes":{"lmkr":"1","list":"indent1","text-indent":"true"},"insert":"*"},{"attributes":{"alt":"图片描述","image":"true","src":"https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3d63494f033046b1980f3d5c4081d5b2~tplv-goo7wpa0wc-topic.webp","uuid":"XByPX12Mc6","width":"1800","loadingStatus":"success"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"indent1","text-indent":"true"},"insert":"*"},{"attributes":{"zero-space-anchor":"true","anchor":".5a6e546w6Z-z6KeG6aKR6YCa6K-d"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#实现音视频通话"},"insert":"*"},{"insert":"实现音视频通话\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\",\"isTitle\":true}"},"insert":"*"},{"insert":"Tip\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\"}"},"insert":"*"},{"insert":"本章节将先向你提供 API 调用时序图和完整的实现代码，再对具体的实现步骤展开介绍。\n"},{"attributes":{"lmkr":"1","heading":"h2","anchor":"#.5pe25bqP5Zu-"},"insert":"*"},{"insert":"时序图\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"下图为使用火山引擎 RTC SDK 实现基础音视频通话的 API 调用时序图。\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"attributes":{"alt":"图片","image":"true","src":"https://lf3-static.bytednsdoc.com/obj/eden-cn/jvKJ%5BY/ljhwZthlaukjlkulzlp/1169314_plantuml_diagram0.png","uuid":"DmroYxqu8W","width":"500","loadingStatus":"success"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h2","anchor":"#.5a6M5pW05Luj56CB56S65L6L"},"insert":"*"},{"insert":"完整代码示例\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"将下面两段代码分别替换 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 和 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.cpp"},{"insert":" 文件中的全部内容，单击 Qt Creator 窗口左下角的运行按钮（或使用 "},{"attributes":{"bold":"true"},"insert":"Command ⌘"},{"insert":" + "},{"attributes":{"bold":"true"},"insert":"R"},{"insert":" 快捷键），即可快速实现音视频通话。\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.bWFpbndpbmRvdy1oLeS7o-eggeWGheWuuQ=="},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 代码内容\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\",\"isTitle\":true}"},"insert":"*"},{"insert":"Tip\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\"}"},"insert":"*"},{"insert":"你需要将 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 中的 "},{"attributes":{"inlineCode":"true"},"insert":"m_roomid"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"m_uid"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"m_appid"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"m_token"},{"insert":" 替换为你在"},{"attributes":{"hyperlink":"{\"href\":\"https://console.volcengine.com/rtc/listRTC?from=doc\",\"linkId\":\"IwPpemPFFz\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"控制台"},{"insert":"上生成临时 Token 时所使用的房间 ID 和用户 ID，以及获取到的 AppID 和临时 Token。\n"},{"attributes":{"type":"codeblock","zoneId":"uZpBwRbhmz","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.bWFpbndpbmRvdy1jcHAt5Luj56CB5YaF5a65"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.cpp"},{"insert":" 代码内容\n"},{"attributes":{"type":"codeblock","zoneId":"oA7QZiiozg","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h2","anchor":"#.5a6e546w5q2l6aqk6K-m6Kej"},"insert":"*"},{"insert":"实现步骤详解\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5byV5YWl5aS05paH5Lu2"},"insert":"*"},{"insert":"引入头文件\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"在 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 中引入以下头文件。\n"},{"attributes":{"type":"codeblock","zoneId":"KCRinlp9ts","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.57un5om_5Zue6LCD57G7"},"insert":"*"},{"insert":"继承回调类\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"EventHandler 类定义在 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 中。 EventHandler 用于接收 "},{"attributes":{"inlineCode":"true"},"insert":"bytertc::IRTCEngineEventHandler"},{"insert":" 及 "},{"attributes":{"inlineCode":"true"},"insert":"bytertc::IRTCRoomEventHandler"},{"insert":" 的回调事件，其中 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70096#IRTSRoomEventHandler-onroomstatechanged\",\"linkId\":\"y3pZW4yxai\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"onRoomStateChanged"},{"insert":" 表示本端进房状态回调，"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70096#IRTCRoomEventHandler-onuserpublishstreamvideo\",\"linkId\":\"qoSJmKdAsH\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"onUserPublishStreamVideo"},{"insert":" 表示同房间内远端是否发视频流回调，"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70096#IRTCRoomEventHandler-onuserpublishstreamaudio\",\"linkId\":\"PrruALUj35\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"onUserPublishStreamAudio"},{"insert":" 表示同房间内远端是否发音频流回调。\n"},{"attributes":{"type":"codeblock","zoneId":"xdNIyx2MeE","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5Yid5aeL5YyW55WM6Z2i5Y-K5Y-C5pWw"},"insert":"*"},{"insert":"初始化界面及参数\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"将以下成员变量定义在 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 文件中的 "},{"attributes":{"inlineCode":"true"},"insert":"MainWindow"},{"insert":" 类中。\n"},{"attributes":{"type":"codeblock","zoneId":"Gp0Ls4sBlV","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"将以下数据类型的定义放在 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.cpp"},{"insert":" 的构造函数 "},{"attributes":{"inlineCode":"true"},"insert":"MainWindow::MainWindow"},{"insert":" 中。\n"},{"attributes":{"type":"codeblock","zoneId":"WQEvIo84fZ","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5Yib5bu65byV5pOO"},"insert":"*"},{"insert":"创建引擎\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"创建引擎放在 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.cpp"},{"insert":" 中的 "},{"attributes":{"inlineCode":"true"},"insert":"MainWindow::MainWindow"},{"insert":" 构造函数中。"},{"attributes":{"inlineCode":"true"},"insert":"createRTCEngine"},{"insert":" 用于创建 RTC 引擎，所有 RTC 相关的 API 调用都要在创建引擎之后。\n"},{"attributes":{"type":"codeblock","zoneId":"dakyxAnYYj","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.6YeH6ZuG6Z-z6KeG6aKR"},"insert":"*"},{"insert":"采集音视频\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"创建引擎后，调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-startaudiocapture\",\"linkId\":\"hqfXXRplhz\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"startAudioCapture"},{"insert":" 开启音频采集，调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-startvideocapture\",\"linkId\":\"aNsHwQZsxx\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"startVideoCapture"},{"insert":" 开启视频采集。\n"},{"attributes":{"type":"codeblock","zoneId":"MJss6CCjMZ","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5riy5p-T5pys56uv6KeG6aKR5rWB"},"insert":"*"},{"insert":"渲染本端视频流\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-setlocalvideocanvas\",\"linkId\":\"ez4HdA2QZD\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"setLocalVideoCanvas"},{"insert":" 设置本端渲染窗口。\n"},{"attributes":{"type":"codeblock","zoneId":"KPCwPAEsjH","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5Yib5bu65bm25Yqg5YWl5oi_6Ze0"},"insert":"*"},{"insert":"创建并加入房间\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-creatertcroom\",\"linkId\":\"c9jHFS2zLc\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"createRTCRoom"},{"insert":" 创建 RTC 房间，所有和房间相关的 API 都在 bytertc::IRTCRoom 内。\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCRoom-joinroom\",\"linkId\":\"hy58qhBEIR\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"joinRoom"},{"insert":" 表示进房，进房状态可以通过 bytertc::IRTCRoomEventHandler 中 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70096#IRTSRoomEventHandler-onroomstatechanged\",\"linkId\":\"rje7n7eS9T\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"onRoomStateChanged"},{"insert":" 回调。\n"},{"attributes":{"type":"codeblock","zoneId":"ooQRZ6uCO1","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5riy5p-T6L-c56uv6KeG6aKR5rWB"},"insert":"*"},{"insert":"渲染远端视频流\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\",\"isTitle\":true}"},"insert":"*"},{"insert":"Tip\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\"}"},"insert":"*"},{"insert":"以下代码在 "},{"attributes":{"inlineCode":"true"},"insert":"sigUserPublishStreamVideo"},{"insert":" 的槽函数中，已在创建引擎步骤中实现，不必重复实现。\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"EventHandler 类继承了 "},{"attributes":{"inlineCode":"true"},"insert":"bytertc::IRTCRoomEventHandler"},{"insert":"，设置 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCRoom-setrtcroomeventhandler\",\"linkId\":\"gIejfPuVvn\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"setRTCRoomEventHandler"},{"insert":" 接收回调通知，回调接口内发射 sigUserPublishStreamVideo 信号，connect 槽中调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-setremotevideocanvas\",\"linkId\":\"aUaUbw4RCU\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"setRemoteVideoCanvas"},{"insert":" 接口，设置远端视频窗口渲染。\n"},{"attributes":{"type":"codeblock","zoneId":"wNK4pFmTvc","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5YGc5q2i5riy5p-T6L-c56uv6KeG6aKR5rWB"},"insert":"*"},{"insert":"停止渲染远端视频流\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\",\"isTitle\":true}"},"insert":"*"},{"insert":"Tip\n"},{"attributes":{"lmkr":"1","tips":"{\"type\":\"tip\"}"},"insert":"*"},{"insert":"以下代码在 "},{"attributes":{"inlineCode":"true"},"insert":"sigUserPublishStreamVideo"},{"insert":" 的槽函数中，已在创建引擎步骤中实现，不必重复实现。\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"实现原理同"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/1169314#.5riy5p-T6L-c56uv6KeG6aKR5rWB\",\"linkId\":\"bkz0IKlXJZ\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"渲染远端视频流"},{"insert":"，当远端用户停止发流后，本端收到 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70096#IRTCRoomEventHandler-onuserpublishstreamaudio\",\"linkId\":\"k6QYA0E0GU\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"onUserPublishStreamAudio"},{"insert":" 回调，通过 sigUserUnpublishStream 信号，在槽函数中设置远端渲染窗口为空。\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5YGc5q2i6Z-z6KeG6aKR6YCa6K-d"},"insert":"*"},{"insert":"停止音视频通话\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"以下代码在 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.cpp"},{"insert":" 析构函数 MainWindow::~MainWindow 中。调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTSRoom-leaveroom\",\"linkId\":\"sKxzW4EFsd\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"leaveRoom"},{"insert":" 离开房间，"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCRoom-destroy\",\"linkId\":\"qmW8tcdxEg\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"destroy"},{"insert":" 销毁房间；调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-stopaudiocapture\",\"linkId\":\"j3JT3hbXHE\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"stopAudioCapture"},{"insert":"、"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-stopvideocapture\",\"linkId\":\"HnO2uOYhtu\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"stopVideoCapture"},{"insert":" 停止音视频采集；调用 "},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/70095#IRTCEngine-destroyrtcengine\",\"linkId\":\"paP0XuSWYK\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"destroyRTCEngine"},{"insert":" 销毁 RTC 引擎。\n"},{"attributes":{"type":"codeblock","zoneId":"Y2xWBYEi9L","language":"cpp","wrap":"true"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h3","anchor":"#.5qOA5p-l6L-b5oi_5Y-C5pWw"},"insert":"*"},{"insert":"检查进房参数\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"至此，代码已经基本搭建完成。将 "},{"attributes":{"inlineCode":"true"},"insert":"mainwindow.h"},{"insert":" 中的 "},{"attributes":{"inlineCode":"true"},"insert":"m_roomid"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"m_uid"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"m_appid"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"m_token"},{"insert":" 替换为你在"},{"attributes":{"hyperlink":"{\"href\":\"https://console.volcengine.com/auth/login/\",\"linkId\":\"HNZJbOKwx8\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"控制台"},{"insert":"上获取的 AppID、临时 Token，以及你在生成临时 Token 时使用的房间 ID 和用户 ID。\n"},{"attributes":{"lmkr":"1","heading":"h2","anchor":"#.57yW6K-R5LiO6L-Q6KGM"},"insert":"*"},{"insert":"编译与运行\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"单击 Qt Creator 窗口左下角的运行按钮（或使用 "},{"attributes":{"bold":"true"},"insert":"Command ⌘"},{"insert":" + "},{"attributes":{"bold":"true"},"insert":"R"},{"insert":" 快捷键）进行编译与调试。\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"attributes":{"alt":"图片","image":"true","src":"https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eb0079b9d75ac82af636beb537e5bf33.png","uuid":"jvKpzR0Zjq","width":"400","loadingStatus":"success"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"如果你想体验双端通话，请在另一台设备上加入同一个 RTC 房间。你需要使用"},{"attributes":{"bold":"true"},"insert":"相同"},{"insert":"的 AppID、"},{"attributes":{"bold":"true"},"insert":"相同"},{"insert":"的房间 ID、"},{"attributes":{"bold":"true"},"insert":"不同"},{"insert":"的用户 ID 生成新的临时 Token。双端通话效果如下：\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"attributes":{"alt":"图片","image":"true","src":"https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_50c886e4cc09e9943439f7a1d23c67ad.png","uuid":"bUOTwzD2p7","width":"600","loadingStatus":"success"},"insert":" "},{"insert":"\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#.5ZCO57ut5q2l6aqk"},"insert":"*"},{"insert":"后续步骤\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"在实现音视频通话后，如遇无声音、无画面、视频卡顿等问题时，您可以使用"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/125643\",\"linkId\":\"MbjrkdLyG1\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"诊断工具"},{"insert":"快速排查和定位异常房间及用户，并获取异常根因分析、处理建议、分析报告等。\n"},{"attributes":{"lmkr":"1","heading":"h1","anchor":"#.5bi46KeB6Zeu6aKY"},"insert":"*"},{"insert":"常见问题\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/1152682#%E5%A6%82%E4%BD%95%E5%9C%A8-macos-%E4%B8%8A%E5%AE%89%E8%A3%85-qt%EF%BC%9F\",\"linkId\":\"ID8aWipNeR\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"如何在 macOS 上安装 Qt？"},{"insert":"\n"},{"attributes":{"lmkr":"1","list":"bullet1","start":"1","origin-start":"1"},"insert":"*"},{"attributes":{"hyperlink":"{\"href\":\"/docs/6348/114721\",\"linkId\":\"J4qMsQmXSq\",\"newTab\":true,\"target\":\"_blank\"}"},"insert":"如何设置日志文件？"},{"insert":"\n\n"}],"zoneId":"0","zoneType":"Z"},"Y2xWBYEi9L":{"ops":[{"insert":"//销毁房间\nif (m_room) {\n m_room->leaveRoom();\n m_room->destroy();\n m_room = nullptr;\n}\n//销毁引擎\nif (m_engine) {\n m_engine->stopAudioCapture();\n m_engine->stopVideoCapture();\n bytertc::IRTCEngine::destroyRTCEngine();\n m_engine = nullptr;\n}\n"}],"zoneId":"Y2xWBYEi9L","zoneType":"Z"},"wNK4pFmTvc":{"ops":[{"insert":"connect(m_handler.get(), &EventHandler::sigUserPublishStreamVideo, this, [this](std::string streamId, bytertc::StreamInfo info, bool publish) {\n qDebug() << Q_FUNC_INFO << \"onUserPublishStreamVideo\"\n << \" streamId:\" << QString::fromStdString(streamId)\n << \" info:\" << (&info)\n << \" pub:\" << publish\n << \" streamId:\" << streamId;\n if (publish) {\n if (m_engine) {\n bytertc::VideoCanvas cas;\n cas.background_color = 0;\n cas.render_mode = bytertc::RenderMode::kRenderModeFit;\n cas.view = (void*)widget_remote->winId();\n m_engine->setRemoteVideoCanvas(streamId.c_str(), cas);\n }\n } else {\n if (m_engine) {\n bytertc::VideoCanvas cas;\n cas.view = nullptr;\n m_engine->setRemoteVideoCanvas(streamId.c_str(), cas);\n }\n }\n});\n"}],"zoneId":"wNK4pFmTvc","zoneType":"Z"},"ooQRZ6uCO1":{"ops":[{"insert":"//进房\nm_room = m_engine->createRTCRoom(m_roomid.c_str());\nif (m_room == nullptr) return;\nbytertc::UserInfo uinfo;\nbytertc::RTCRoomConfig conf;\nuinfo.extra_info = nullptr;\nuinfo.uid = m_uid.c_str();\nconf.is_auto_publish_audio = true;\nconf.is_auto_publish_video = true;\nconf.is_auto_subscribe_audio = true;\nconf.is_auto_subscribe_video = true;\n\n// 加入房间是否成功的提示消息，此部分为可选项目\nint joinRoomResult = m_room->joinRoom(m_token.c_str(), uinfo, true, conf);\nQMessageBox box(QMessageBox::Warning, QStringLiteral(\"加入房间状态\"), QString::number(joinRoomResult), QMessageBox::Ok);\nbox.exec();\n\nm_room->setRTCRoomEventHandler(m_handler.get());\n"}],"zoneId":"ooQRZ6uCO1","zoneType":"Z"},"KPCwPAEsjH":{"ops":[{"insert":"//设置本地预览窗口\nbytertc::VideoCanvas cas;\ncas.background_color = 0;\ncas.render_mode = bytertc::RenderMode::kRenderModeFit;\ncas.view = (void*)widget_local->winId();\nm_engine->setLocalVideoCanvas(cas);\n"}],"zoneId":"KPCwPAEsjH","zoneType":"Z"},"MJss6CCjMZ":{"ops":[{"insert":"//开启音视频采集\nm_engine->startAudioCapture();\nm_engine->startVideoCapture();\n"}],"zoneId":"MJss6CCjMZ","zoneType":"Z"},"dakyxAnYYj":{"ops":[{"insert":"//开始RTC接口调用，检查参数是否为空\nif (m_appid.empty() || m_uid.empty() || m_roomid.empty()) {\n QMessageBox box(QMessageBox::Warning, QStringLiteral(\"提示\"), QString(\"paras is empty\"), QMessageBox::Ok);\n box.exec();\n return;\n}\n\n//创建　EventHandler 对象，用于接收房间、引擎通知\nm_handler = std::make_shared();\n\nconnect(m_handler.get(), &EventHandler::sigRoomStateChanged, this, [](std::string roomid, std::string uid, int state, std::string extra_info) {\n //房间状态变化\n qDebug() << Q_FUNC_INFO << \"roomid=\" << QString::fromStdString(roomid) << \",uid=\" << QString::fromStdString(uid) << \",state=\" << QString::number(state);\n});\n\nbytertc::EngineConfig engConf;\nengConf.app_id = m_appid.c_str();\nm_engine = bytertc::IRTCEngine::createRTCEngine(engConf, m_handler.get());\nif (m_engine == nullptr) return;\n"}],"zoneId":"dakyxAnYYj","zoneType":"Z"},"WQEvIo84fZ":{"ops":[{"insert":"qRegisterMetaType();\n//初始化UI样式\nthis->resize(500, 500);\nQWidget* centralWidget = new QWidget(this);\nQHBoxLayout* lay = new QHBoxLayout(centralWidget);\nwidget_local = new QWidget(this);\nwidget_remote = new QWidget(this);\nlay->addWidget(widget_local);\nlay->addWidget(widget_remote);\nwidget_local->setFixedSize(200, 200);\nwidget_remote->setFixedSize(200, 200);\nwidget_local->show();\nwidget_remote->show();\nthis->setCentralWidget(centralWidget);\n"}],"zoneId":"WQEvIo84fZ","zoneType":"Z"},"Gp0Ls4sBlV":{"ops":[{"insert":"private:\nQWidget* widget_local = nullptr;\nQWidget* widget_remote = nullptr;\n\nbytertc::IRTCEngine* m_engine = nullptr;\nbytertc::IRTCRoom* m_room = nullptr;\n\nstd::string m_roomid = \"123\"; //房间id，请在此处填写自己的房间id\nstd::string m_uid = \"MAC1\"; //用户id，请在此处填写自己的用户id\nstd::string m_appid = \"123\"; //appid，请在此处填写应用的appid\nstd::string m_token = \"\"; //token，请将控制台生成的token填写在此处，要求与上面的roomid、uid对应\n\nstd::shared_ptr m_handler;\n"}],"zoneId":"Gp0Ls4sBlV","zoneType":"Z"},"xdNIyx2MeE":{"ops":[{"insert":"//EventHandler 类继承了 QObject，用于发送信号\n//EventHandler 类继承了 bytertc::IRTCRoomEventHandler 用于接收房间内通知消息\n//声明信号槽中要用到的数据类型\n\nQ_DECLARE_METATYPE(std::string)\n\nclass EventHandler : public QObject, public bytertc::IRTCEngineEventHandler, public bytertc::IRTCRoomEventHandler {\n Q_OBJECT\npublic:\n void onRoomStateChanged(const char* room_id, const char* uid, int state, const char* extra_info) override {\n if (room_id != nullptr && uid != nullptr) {\n std::string str_extra_info = extra_info ? extra_info : \"\";\n emit sigRoomStateChanged(std::string(room_id), std::string(uid), state, str_extra_info);\n }\n }\n\n void onUserPublishStreamVideo(const char* streamId, const bytertc::StreamInfo& info, bool is_publish) override {\n if (streamId != nullptr) {\n emit sigUserPublishStreamVideo(streamId, info, is_publish);\n }\n\n }\n\n void onUserPublishStreamAudio(const char* streamId, const bytertc::StreamInfo& info, bool is_publish) override {\n if (streamId != nullptr) {\n emit sigUserPublishStreamAudio(streamId, info, is_publish);\n }\n }\n\nsignals:\n void sigRoomStateChanged(std::string roomid, std::string uid, int state, std::string extra_info);\n void sigUserPublishStreamVideo(std::string streamId, bytertc::StreamInfo info, bool publish);\n void sigUserPublishStreamAudio(std::string streamId, bytertc::StreamInfo info, bool publish);\n};\n"}],"zoneId":"xdNIyx2MeE","zoneType":"Z"},"KCRinlp9ts":{"ops":[{"insert":"#include \"bytertc_engine.h\"\n#include \"bytertc_room.h\"\n#include \"bytertc_room_event_handler.h\"\n#include \"bytertc_engine_event_handler.h\"\n#include \n#include \n#include \n#include \n#include \n"}],"zoneId":"KCRinlp9ts","zoneType":"Z"},"oA7QZiiozg":{"ops":[{"insert":"// 以下为 mainwindow.cpp 的完整代码内容\n\n#include \"mainwindow.h\"\n#include \"ui_mainwindow.h\"\n\nMainWindow::MainWindow(QWidget *parent)\n : QMainWindow(parent)\n , ui(new Ui::MainWindow)\n{\n ui->setupUi(this);\n\n qRegisterMetaType();\n\n //初始化UI样式\n this->resize(500, 500);\n QWidget* centralWidget = new QWidget(this);\n QHBoxLayout* lay = new QHBoxLayout(centralWidget);\n widget_local = new QWidget(this);\n widget_remote = new QWidget(this);\n lay->addWidget(widget_local);\n lay->addWidget(widget_remote);\n widget_local->setFixedSize(200, 200);\n widget_remote->setFixedSize(200, 200);\n widget_local->show();\n widget_remote->show();\n this->setCentralWidget(centralWidget);\n\n //开始RTC接口调用，检查参数是否为空\n if (m_appid.empty() || m_uid.empty() || m_roomid.empty()) {\n QMessageBox box(QMessageBox::Warning, QStringLiteral(\"提示\"), QString(\"paras is empty\"), QMessageBox::Ok);\n box.exec();\n return;\n }\n\n //创建　EventHandler 对象，用于接收房间、引擎通知\n m_handler = std::make_shared();\n connect(m_handler.get(), &EventHandler::sigRoomStateChanged, this, [](std::string roomid, std::string uid, int state, std::string extra_info) {\n //房间状态变化\n qDebug() << Q_FUNC_INFO << \"roomid=\" << QString::fromStdString(roomid) << \",uid=\" << QString::fromStdString(uid) << \",state=\" << QString::number(state);\n });\n\n connect(m_handler.get(), &EventHandler::sigUserPublishStreamVideo, this, [this](std::string streamId, bytertc::StreamInfo info, bool publish) {\n qDebug() << Q_FUNC_INFO << \"onUserPublishStreamVideo\"\n << \" streamId:\" << QString::fromStdString(streamId)\n << \" info:\" << (&info)\n << \" pub:\" << publish\n << \" streamId:\" << streamId;\n if (publish) {\n if (m_engine) {\n bytertc::VideoCanvas cas;\n cas.background_color = 0;\n cas.render_mode = bytertc::RenderMode::kRenderModeFit;\n cas.view = (void*)widget_remote->winId();\n m_engine->setRemoteVideoCanvas(streamId.c_str(), cas);\n }\n } else {\n if (m_engine) {\n bytertc::VideoCanvas cas;\n cas.view = nullptr;\n m_engine->setRemoteVideoCanvas(streamId.c_str(), cas);\n }\n }\n });\n\n bytertc::EngineConfig engConf;\n engConf.app_id = m_appid.c_str();\n m_engine = bytertc::IRTCEngine::createRTCEngine(engConf, m_handler.get());\n if (m_engine == nullptr) return;\n //开启音视频this\n m_engine->startAudioCapture();\n m_engine->startVideoCapture();\n //设置本地预览窗口\n bytertc::VideoCanvas cas;\n cas.background_color = 0;\n cas.render_mode = bytertc::RenderMode::kRenderModeFit;\n cas.view = (void*)widget_local->winId();\n m_engine->setLocalVideoCanvas(cas);\n\n //进房\n m_room = m_engine->createRTCRoom(m_roomid.c_str());\n if (m_room == nullptr) return;\n bytertc::UserInfo uinfo;\n bytertc::RTCRoomConfig conf;\n uinfo.extra_info = nullptr;\n uinfo.uid = m_uid.c_str();\n conf.is_auto_publish_audio = true; // 原为 is_publish_audio\n conf.is_auto_publish_video = true; // 原为 is_publish_video\n conf.is_auto_subscribe_audio = true;\n conf.is_auto_subscribe_video = true;\n\n int joinRoomResult = m_room->joinRoom(m_token.c_str(), uinfo, true, conf);\n QMessageBox box(QMessageBox::Warning, QStringLiteral(\"加入房间状态\"), QString::number(joinRoomResult), QMessageBox::Ok);\n box.exec();\n\n m_room->setRTCRoomEventHandler(m_handler.get());\n}\n\nMainWindow::~MainWindow()\n{\n //销毁房间\n if (m_room) {\n // m_room->leaveRoom();\n m_room->destroy();\n m_room = nullptr;\n }\n\n //销毁引擎\n if (m_engine) {\n m_engine->stopAudioCapture();\n m_engine->stopVideoCapture();\n bytertc::IRTCEngine::destroyRTCEngine();\n m_engine = nullptr;\n }\n delete ui;\n}\n"}],"zoneId":"oA7QZiiozg","zoneType":"Z"},"uZpBwRbhmz":{"ops":[{"insert":"// 以下为 mainwindow.h 的完整代码内容\n// 以下为 mainwindow.h 的完整代码内容\n\n#ifndef MAINWINDOW_H\n#define MAINWINDOW_H\n\n#include \n\n#include \"bytertc_engine.h\"\n#include \"bytertc_room.h\"\n#include \"bytertc_room_event_handler.h\"\n#include \"bytertc_engine_event_handler.h\"\n#include \n#include \n#include \n#include \n#include \n\nQT_BEGIN_NAMESPACE\nnamespace Ui { class MainWindow; }\nQT_END_NAMESPACE\n\n\n//EventHandler 类继承了 QObject，用于发送信号\n//EventHandler 类继承了 bytertc::IRTCRoomEventHandler 用于接收房间内通知消息\n//声明信号槽中要用到的数据类型\nQ_DECLARE_METATYPE(std::string)\n\nclass EventHandler : public QObject, public bytertc::IRTCEngineEventHandler, public bytertc::IRTCRoomEventHandler {\n Q_OBJECT\npublic:\n void onRoomStateChanged(\n const char* room_id, const char* uid, int state, const char* extra_info) override {\n if (room_id != nullptr && uid != nullptr) {\n std::string str_extra_info = extra_info ? extra_info : \"\";\n emit sigRoomStateChanged(std::string(room_id), std::string(uid), state, str_extra_info);\n }\n }\n\n void onUserPublishStreamVideo(const char* room_id, const char* uid, bool is_publish) override{\n if (room_id != nullptr && uid != nullptr) {\n emit sigUserPublishStreamVideo(room_id, uid, is_publish);\n }\n\n }\n void onUserPublishStreamAudio(const char* room_id, const char* uid, bool is_publish) override{\n if (room_id != nullptr && uid != nullptr) {\n emit sigUserPublishStreamAudio(room_id, uid, is_publish);\n }\n }\n\n\nsignals:\n void sigRoomStateChanged(std::string roomid, std::string uid, int state, std::string extra_info);\n void sigUserPublishStreamVideo(std::string roomid, std::string uid, bool publish);\n void sigUserPublishStreamAudio(std::string roomid, std::string uid, bool publish);\n};\n\nclass MainWindow : public QMainWindow\n{\n Q_OBJECT\n\npublic:\n MainWindow(QWidget *parent = nullptr);\n ~MainWindow();\n\nprivate:\n Ui::MainWindow *ui;\n\nprivate:\n QWidget* widget_local = nullptr;\n QWidget* widget_remote = nullptr;\n\n bytertc::IRTCEngine* m_engine = nullptr;\n bytertc::IRTCRoom* m_room = nullptr;\n\n std::string m_roomid = \"123\"; //房间id，请在此处填写自己的房间id\n std::string m_uid = \"MAC1\"; //用户id，请在此处填写自己的用户id\n std::string m_appid = \"123\"; //appid，请在此处填写应用的appid\n std::string m_token = \"\"; //token，请将控制台生成的token填写在此处，要求与上面的roomid、uid对应\n\n std::shared_ptr m_handler;\n};\n#endif // MAINWINDOW_H\n\n\n"}],"zoneId":"uZpBwRbhmz","zoneType":"Z"},"lKBXNhPFYN":{"ops":[{"insert":"QMAKE_INFO_PLIST = $$PWD/Info.plist\nTARGET = RTCTest\nTEMPLATE = app\nDESTDIR = $$PWD/bin\n\nINCLUDEPATH += $$PWD/VolcEngineRTC/VolcEngineRTC.framework/Headers/native\nLIBS += $$PWD/VolcEngineRTC/VolcEngineRTC.framework/Versions/3/VolcEngineRTC\n\nPATH=$$PWD//VolcEngineRTC/*\nQMAKE_POST_LINK += $$[QT_INSTALL_BINS]/macdeployqt $$DESTDIR/RTCTest.app\nQMAKE_POST_LINK += && cp -R $$system_path($$PATH) $$system_path($$DESTDIR/RTCTest.app/Contents/Frameworks)\n"}],"zoneId":"lKBXNhPFYN","zoneType":"Z"},"sFtJXDeeMg":{"ops":[{"insert":".\n├── RTCTest.pro\n├── VolcEngineRTC\n│ ├── ByteRTCFDK-AACExtension.framework\n│ ├── ByteRTCFFmpegAudioExtension.framework\n│ ├── ByteRTCNICOExtension.framework\n│ ├── ByteRTCVp8CodecExtension.framework\n│ ├── libbdaudioeffect.dylib\n│ ├── libbytenn.dylib\n│ ├── libbytevc0.dylib\n│ ├── libeffect.dylib\n│ ├── RTCFFmpeg.framework\n│ └── VolcEngineRTC.framework\n├── main.cpp\n├── mainwindow.cpp\n├── mainwindow.h\n├── Info.plist\n└── mainwindow.ui\n"}],"zoneId":"sFtJXDeeMg","zoneType":"Z"}}}