WordPress 插件整合指南
使用 WebLiveHub 串流 透过将您的网站连接到 WordPress,将 WebLiveHub 串流内容嵌入到 WordPress 中 托管后端.
WordPress 整合
使用 WebLiveHub Stream 嵌入流(区块优先)
WebLiveHub Stream 是一个 WordPress 插件,透过将您的网站连接到 WebLiveHub 来嵌入 WebLiveHub 串流内容 托管后端.
相容性
- 至少需要:WordPress
6.0 - 已测试:WordPress
6.9 - 需要 PHP:
8.0
它是如何运作的
- 您的 WordPress 网站连接到托管后端。
- 此插件生成嵌入令牌 伺服器端 (将凭证保留在贴文/页面之外)。
- 此页面呈现 WebLiveHub 播放器。
开始前准备
你需要一个可管理的 WordPress 网站,以及已为主播准备好的 WebLiveHub 连接。
- 在 Console → Hosted Backends 复制要使用的后端服务 URL。该后端的 Allowed Origins 必须包含你的 WordPress 网站来源网址(origin)。
- 在 Console → Users 找到已授权的连接身份和主播的公开 User ID。连接密码属于该串流身份,不是 WordPress 管理员密码,也不是 Google 登录密码。
- 主播页面须使用相符的主播账户。请直接在 WordPress 设置中输入连接密码;不要把密码放在页面内容或支持消息中。
- 使用可访问摄像头和麦克风的浏览器,并在浏览器及操作系统权限中允许使用这两项设备。
如果账户、后端或主播身份尚未准备好,请通过联系页面提供网站网址及预期用途。请勿发送密码或 token。
安装与支持
源代码版本: GitHub 上的 WebLiveHub Stream v1.1.0
请从 GitHub 发布页下载 v1.1.0 源代码 ZIP。在 WordPress 后台依次选择“插件 → 安装插件 → 上传插件”,选中 ZIP,点击“立即安装”,然后启用插件。已在官方 WordPress Playground(WordPress 6.9/PHP 8.3)成功上传、安装、启用并打开设置页;本次只验证新安装,未测试旧版升级、后端连接或直播。插件目前未通过 WordPress.org 发布。
创建主播页面
- 从 v1.1.0 Release 下载 Source code (zip)。在 WordPress 中依次打开 Plugins → Add New Plugin → Upload Plugin,安装 ZIP 并启用 WebLiveHub Stream。
- 打开 Settings → WebLiveHub Stream。使用 Quick Setup 保存 Hosted Backend 服务 URL,以及相符的连接身份和密码。保存只表示设置已写入;仍须按下方步骤确认开播。
- 在创建页面的区域选择主播用途,输入相符主播的公开 User ID,然后创建页面草稿。如果有多组连接,请明确选择后端和身份。
- 检查草稿中已填入的区块,预览页面,确认后再发布。创建草稿不会自动发布页面。
- 打开主播页面,在浏览器及操作系统中允许摄像头和麦克风,并使用页面上的开始控件进行本次活动。
- 确认加载遮罩已隐藏或取消,而且主播计时器已开始。活动结束时,使用界面结束直播。
下次有真实活动时,重复使用这个主播页面,并再次确认上述开播信号。
重复使用主播页面
保留可正常使用的主播页面,供日后活动重复使用。需要更改主播或版面时,可编辑页面中现有的 WebLiveHub Stream 区块。
手动添加区块、多组连接、短代码及自定义 CSS 仍可用于进阶设置;使用 Quick Setup 和创建草稿的流程时,无需先进行这些操作。
如果设备权限被拒绝或加载持续进行,请检查浏览器及操作系统中的摄像头和麦克风权限。联系支持时,请说明进行到哪一步、插件及浏览器版本,并提供已移除密码和 token 的可见错误信息。
主机标签备忘录
| 主机标签 | 何时使用 |
|---|---|
| 连接 | 测试/PoC/一般默认 |
| 观看 | 串流媒体/广播模式(上游+控制) |
| 即时客户端 | 查看器模式(观看) |
进阶/旧版:简码使用
定位指南:将短代码视为遗留工作流程的可选后备方案。
[weblivehub_stream streamer="STREAMER_USER_ID"][weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" width="100%" height="600px"]
[weblivehub_stream streamer="STREAMER_USER_ID" host_label="live" style="width: 100%; height: 600px; display: block;"]安全说明: 仅将托管后端凭证储存在 设置 → WebLiveHub 串流。不要将凭证贴到贴文/页面中。
有真实的 WordPress 直播用途吗?请联系我们讨论设置。请提供网站网址及预计首次使用日期;未定可写“未定”。请勿发送密码或令牌。