macOS开播小助手

更新时间: 2023-07-28 10:40:20

针对互动直播场景横屏样式,AUI Kits 低代码集成工具提供macOS端的开播客户端《开播小助手》。

通过该客户端,主播用户可以实现以下开播功能:

  • 摄像头采集视频画面推流,支持切换至外接摄像设备,支持美颜特效设定(需要额外付费)。

  • 麦克风采集音频信号推流,支持切换至外设麦克风设备。

  • 设定直播画质。

  • 聊天互动,支持设定全员禁言。

说明

集成方可以通过URL唤起《开播小助手》,若需要基于《开播小助手》进行二次开发,请您联系商务经理沟通定向开源事宜。

更多AUI Kits问题咨询及使用说明,请搜索钉钉群(35685013712)加入AUI客户支持群联系我们。

前提条件

为保证开播小助手能够正常使用,请确保您的设备满足以下条件:

  • 机型:推荐使用2017年发布及后续发布机型。

  • 操作系统:支持macOS10.14及以上。

  • 麦克风:推荐使用外置麦克风或者带麦克风的耳机。

  • 网络:推荐10 Mbps及以上的上行带宽。

下载安装

下载地址

下载地址请参见macOS端开播小助手

安装说明

  • 安装时,请将App拖动至应用程序目录。

  • 如果打开过程中提示”无法打开开播小助手.app“,需通过系统设置 > 隐私与安全性 > 安全性手动打开应用。

集成唤起

推荐集成方以如下逻辑唤起开播小助手,以下功能需要您根据您的系统自行开发:

image.png

获取开播链接

前提条件

所使用的接口依赖于AppServer服务,请先部署、运行、接入直播间AppServer,操作方式参见服务端集成

示例代码

以下为生成开播链接的示例代码,需要在项目中引入依赖axios,引入示例:npm install axios --save,您可以根据您的实际情况换用其他的HTTP库。

import axios from 'axios';
// 这里填入您的 Appserver 域名,结尾字符请勿是 /
const origin = '';
const username = 'AUILivePusher';
const password = username;
const anchorNick = '小助手测试员';

async function genurl() {
 // 先调用 login 接口获取 token
 const res = await axios.post(
 `${origin}/api/v1/live/login`,
 {
 username,
 password,
 },
 {
 headers: {
 accept: 'application/json',
 'Content-Type': 'application/json',
 },
 }
 );
 const { token } = res.data;

 const now = new Date();
 // 创建直播间,获取直播间 id
 const liveIdRes = await axios.post(
 `${origin}/api/v1/live/create`,
 {
 anchor: username,
 anchor_nick: anchorNick,
 extends: '',
 mode: 0,
 notice: '直播公告',
 title: `直播测试${now.getMonth() + 1}${now.getDate()}`,
 },
 {
 headers: {
 Authorization: `Bearer ${token}`,
 accept: 'application/json',
 'Content-Type': 'application/json',
 },
 }
 );
 const { id: liveId } = liveIdRes.data;

 // 最后调用 getLiveJumpUrl 获取开播链接
 const urlRes = await axios.post(
 `${origin}/api/v1/live/getLiveJumpUrl`,
 {
 live_id: liveId,
 user_id: username,
 user_name: anchorNick,
 },
 {
 headers: {
 Authorization: `Bearer ${token}`,
 accept: 'application/json',
 'Content-Type': 'application/json',
 },
 }
 );
 // 返回的 data.live_jump_url 字段即为开播链接
 return urlRes.data.live_jump_url;
}

// 结合您的工程在合适的位置调用 genurl 函数
genurl().then((url) => {
 console.log('url ->', url);
});

唤端示例

需要在项目中引入依赖custom-protocol-check,引入示例:npm install custom-protocol-check --save

import customProtocolCheck from "custom-protocol-check";

// 链接为上方 genurl 生成的地址,或其他方案通过 getLiveJumpUrl 接口得到的地址
const url = `auipusher://page/live-room?xxxxxx`;

customProtocolCheck(
 url,
 (res) => {
 // 呼起成功
 console.log('callClient->success! ');
 },
 (res) => {
 // 没有协议
 // 建议此处实现提示下载的弹窗
 },
);

开始直播

  1. 登录开播小助手。当前支持外部唤起和手动进入两种登录方式。

    • 外部唤起:在浏览器中通过唤端URL打开开播小助手,客户端解析出服务器、直播间、主播信息后,会自动登入。

    • 手动进入:点击开播小助手快捷方式,进入登录页面,键入唤端URL,点击进入直播间,客户端解析出服务器、直播间、主播信息后,会自动登入。

  2. (可选)设置摄像头设备。

    首次使用时需要允许使用摄像头。后续也可以通过系统设置 > 隐私与安全性 > 摄像头允许开播小助手访问摄像头。

    • 关闭/开启摄像头:单击摄像头图标,切换摄像头状态;进入直播间时,默认开启摄像头。

    • 切换摄像头:单击摄像头图标旁的三角图标,唤出摄像头列表,点击选择指定的视频源输入设备。

  3. (可选)设置麦克风设备。

    首次使用需要允许使用麦克风。后续也可以通过系统设置 > 隐私与安全性 > 麦克风允许开播小助手访问麦克风

    • 关闭/开启麦克风:单击麦克风图标,切换麦克风状态;进入直播间时,默认开启麦克风。

    • 切换麦克风:单击麦克风图标旁的三角图标,唤出麦克风列表,点击选择指定的音频源输入设备。

  4. (可选)共享屏幕。

    首次使用共享屏幕功能,需要通过系统设置 > 隐私与安全性 > 屏幕录制为开播小助手打开屏幕录制权限。

    • 共享屏幕/窗口:单击共享屏幕按钮,在打开的弹窗中选择屏幕或窗口,即可分享对应画面。

    • 结束共享:共享屏幕/窗口时,会出现结束共享按钮,点击结束共享。

  5. (可选)根据当前网速选择推荐的直播画质。

    1. 单击设置图标,唤出设置弹窗。

    2. 选择所需画质。如果选择自定义画质,则主播可以自行设定推流的分辨率、码率、帧率等。

      说明

      建议在开播之前完成设定,如果在直播、连麦或录制视频期间调整直播画质,会直接影响观看效果。

  6. 完成相关配置并单击开始直播

准备观看

推流使用的音频格式是Opus,建议设置转码以确保播放端的兼容性。以普通直播观看为例,操作步骤如下:

  1. 登录视频直播控制台

  2. 在视频直播控制台左侧导航栏,单击域名管理,进入域名管理页面。

  3. 选择您要配置的播流域名,单击操作域名配置image.png

  4. 单击模版配置 > 转码模板配置

  5. 通用转码页签下,单击添加

  6. 在配置转码模板页面,选择原画-仅转音频模板,并将编码格式设置为AACimage.png

  7. 单击确定,完成配置,并将对应转码后的播流地址在直播间详情接口中返回。

  8. 如需直播回看,需要添加录制配置。

    单击模版配置 > 录制配置,在存储至VOD存储至OSS的页签下,点击添加,在弹窗中开启录制转码流,而转码模板ID选择oriaac,点击确定即可。

阿里云首页 音视频终端 SDK 相关技术圈