直播推流初始化设置
要进行直播推流,您必须开启直播加速 > 配置直播域名 > 直播推流,详情参考 。
如何获取推流地址
直播加速配置成功后,您可以通过以下方式获取对应的推流地址。
登录 视频直播控制台。
- 单击 域名管理。
- 选择所需地域。
- 选择所需的域名。
- 选择所需域名,并单击右侧的 管理。
- 在 基本信息 中,获取对应的推流地址:rtmp://video-center.alivecdn.com/AppName/StreamName?vhost=videolive.aliyuntest.club 。
注意:
- 直播配置成功后,对应的推流地址获取是不需要调用 API 或者 SDK 生成或者初始化的,使用推流工具推流的时候,填入需要的 AppName 或者 StreamName 进行推流即可。如指定推流地址:rtmp://video-center.alivecdn.com/1/2?vhost=live.aliyun.com。
- 推流地址中 APPName 是应用名称,支持自定义,可以更改。
- 推流地址中 StreamName 是流名称,支持自定义,可以更改。
- 推流的 APPName 或 StreamName 不建议设置为中文字符。
为何OBS推流不成功
OBS 推流不成功,对应 视频直播控制台 > 流管理,正在推流信息中不能看到对应流.OBS如何进行推流,详情参考 OBS 操作指南。
排查
- 排查对应域名是否进行直播配置:视频直播控制台 > 域名管理 中能否看到对应的域名。直播加速配置。
- 排查OBS推流配置填写的是否准确。
OBS推流配置如下:
FMS URL / URL: rtmp://video-center.alivecdn.com/AppName
播放路径/串码流(如果存在)/ 流秘钥: StreamName?vhost=live.aliyun.com
- 排查直播域名是否开启了A鉴权。
- 登录 视频直播控制台。
- 单击 域名管理。
- 选择所需的地域。
- 选择所需的域名。
- 单击所选域名右侧 管理。
- 单击 鉴权配置。
如果开启,计得算推流地址(rtmp://video-center.alivecdn.com/AppName/StreamName?vhost=videolive.aliyuntest.club)的鉴权地址进行推流,鉴权地址计算参考 第4点鉴权配置。
直播推流支持哪些协议
视频直播只支持rtmp协议推流
直播推流如何进行鉴权推流
直播鉴权开启及鉴权地址计算参考第4点鉴权配置。
鉴权地址计算完成后,使用对应的鉴权地址进行推流:
OBS推流配置类似如下:
FMS URL / URL: rtmp://video-center.alivecdn.com/AppName
播放路径/串码流(如果存在)/ 流秘钥: StreamName?vhost=live8.aliyuntest.club&auth_key=1487766738-0-0-a96e76d2ebf9bbd855b0d4a9168ee600;
如何确认推流成功
- 登录 视频直播控制台。
- 单击 流管理。
- 选择所需的地域。
- 选择所需的域名。
- 流状态选择 正在推流。
- 如果可以查看到存在对应流,则推流成功。
禁止推流的情况该如何实现?
用户存在业务场景需求某路流临时禁止推流。例如,对应的鉴权推流地址暴露,客户恶意推流该地址、业务需求禁止该推流URL进行推流等,就可以使用直播的禁止推流功能满足该需求。推流及鉴权推流地址概念参考 直播推流地址相关问题。
直播控制台禁止推流
1.获取正在推流地址并加入黑名单
直播推流成功后,您可以在 视频直播控制台 > 流管理 > 选择所需的地域和域名 > 选择正在推流,查看到正在推流的地址,单击 加入黑名单 即可。
2.获取历史推流地址并加入黑名单
直播推流成功后,您可以在 视频直播控制台 > 流管理 > 选择所需的地域和域名 > 选择历史推流,查看到历史推流地址,单击 加入黑名单 即可。
SDK实现禁止推流
视频直播的API是基于阿里云的OpenAPI实现的。因此,SDK的调用也是对OpenAPI封装后调用。以Java SDK为例,Java SDK建议使用maven管理项目依赖,在pom.xml中添加如下的依赖项:
<dependencies>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-cdn</artifactId>
<version>2.3.1</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<optional>true</optional>
<version>2.3.8</version>
</dependency>
</dependencies>
其中,aliyun-java-sdk-core是对阿里云OpenAPI封装的核心模块,在使用OpenAPI的产品调用Java SDK均需要添加该依赖项,而aliyun-java-sdk-cdn包括了视频直播接口的Request和Response类;其中禁止推流的Request和Response类为ForbidLiveStreamRequest及ForbidLiveStreamResponse,Java代码示例如下:
public static void main(String[] args) throws Exception {
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessId, accessKey);
DefaultAcsClient client = new DefaultAcsClient(profile);
ForbidLiveStreamResponse res=ForbidLiveStreamR(client);
System.out.println(res.getRequestId());
}
static ForbidLiveStreamResponse ForbidLiveStreamR(DefaultAcsClient client){
ForbidLiveStreamRequest request =new ForbidLiveStreamRequest();
request.setDomainName("<DomainName>");
request.setAppName("<AppName>");
request.setStreamName("<StreamName>");
request.setLiveStreamType("publisher");
ForbidLiveStreamResponse response=null;
try {
response = client.getAcsResponse(request);
}catch (ServerException e) {
e.printStackTrace();
}
catch (ClientException e) {
e.printStackTrace();
}
return response;
}
Demo代码主要流程如下:
初始化Client对象。SDK需要通过IAcsClient对象完成对OpenAPI的调用,而初始化IAcsClient对象时根据IClientProfile对象配置region、AccessKeyId和AccessKeySecret参数。其中,region请一直写cn-hangzhou,因为这里指的是OpenAPI的服务器所在区域。AccessKeyId和AccessKeySecret参数即是账号权限验证,如果是主账号的AccessKeyId和AccessKeySecret,则可以正常使用。如果是子账号的AccessKeyId和AccessKeySecret参数,则需要保证该子账号有视频直播的权限。
初始化请求Request类。SDK对每个接口实现了对应的Request类和Response类,对应的禁止推流Request类需要传入哪些参数,看API接口定义 禁止推流API。
发起请求获取结果。使用Client对象的getAcsResponse方法发起Request对象请求,并根据该方法反馈的反序列化的结果实例化为对应接口的Response类。并且在执行该方法时可以catch ServerException和ClientException异常类,当http status>=300且<500 SDK抛ClientException,表示客户端错误。当http status>=500 SDK抛ServerException,表示服务器端错误。如果没有抛出异常则表示接口调用成功。
如何查看推流黑名单
1.直播控制台查看推流黑名单
直播推流成功后,您可以在 视频直播控制台 > 流管理 > 选择所需的地域和域名 > 选择黑名单,查看到黑名单中的推流地址。
2.SDK获取黑名单地址视频直播的API是基于阿里云的OpenAPI实现的,因此SDK的调用也是对OpenAPI封装后调用。以Java SDK为例:Java SDK建议使用maven管理项目依赖,在pom.xml中添加如下的依赖项:
<dependencies>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-cdn</artifactId>
<version>2.3.1</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<optional>true</optional>
<version>2.3.8</version>
</dependency>
</dependencies>
其中,aliyun-java-sdk-core是对阿里云OpenAPI封装的核心模块,在使用OpenAPI的产品调用Java SDK均需要添加该依赖项,而aliyun-java-sdk-cdn包括了视频直播接口的Request和Response类。其中,查询推流黑名单列表的Request和Response类为DescribeLiveStreamsBlockListRequest及DescribeLiveStreamsBlockListResponse,Java代码示例如下:
public static void main(String[] args) throws Exception {
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessId, accessKey);
DefaultAcsClient client = new DefaultAcsClient(profile);
DescribeLiveStreamsBlockListResponse res=DescribeLiveStreamsBlockListR(client);
System.out.println(res.getStreamUrls());
}
static DescribeLiveStreamsBlockListResponse DescribeLiveStreamsBlockListR(DefaultAcsClient client){
DescribeLiveStreamsBlockListRequest request =new DescribeLiveStreamsBlockListRequest();
request.setDomainName("<DomainName>");
DescribeLiveStreamsBlockListResponse response=null;
try {
response = client.getAcsResponse(request);
}catch (ServerException e) {
e.printStackTrace();
}
catch (ClientException e) {
e.printStackTrace();
}
return response;
}
Demo代码主要流程如下:
初始化Client对象。SDK需要通过IAcsClient对象完成对OpenAPI的调用,而初始化IAcsClient对象时根据IClientProfile对象配置region、AccessKeyId和AccessKeySecret参数。其中,region请一直写cn-hangzhou,因为这里指的是OpenAPI的服务器所在区域。AccessKeyId和AccessKeySecret参数即是账号权限验证,如果是主账号的AccessKeyId和AccessKeySecret则可以正常使用,如果是子账号的AccessKeyId和AccessKeySecret参数则需要保证该子账号有视频直播的权限。
初始化请求Request类。SDK对每个接口实现了对应的Request类和Response类,对应的禁止推流Request类需要传入哪些参数,看API接口定义 查询推流黑名单列表API。
发起请求获取结果。使用Client对象的getAcsResponse方法发起Request对象请求,并根据该方法反馈的反序列化的结果实例化为对应接口的Response类。并且在执行该方法时可以catch ServerException和ClientException异常类,当http status>=300且<500 SDK抛ClientException,表示客户端错误。当http status>=500 SDK抛ServerException,表示服务器端错误。如果没有抛出异常则表示接口调用成功。
如何恢复黑名单直播流推送地址
1.直播控制台恢复
直播推流成功后,您可以在 视频直播控制台 > 流管理 > 选择所需的地域和域名 > 选择正在推流 > 选择黑名单,查看到黑名单中的推流地址,进行恢复。
2.SDK恢复黑名单直播流推送地址
视频直播的API是基于阿里云的OpenAPI实现的,因此SDK的调用也是对OpenAPI封装后调用。以Java SDK为例。Java SDK建议使用maven管理项目依赖,在pom.xml中添加如下的依赖项:
<dependencies>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-cdn</artifactId>
<version>2.3.1</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<optional>true</optional>
<version>2.3.8</version>
</dependency>
</dependencies>
其中,aliyun-java-sdk-core是对阿里云OpenAPI封装的核心模块,在使用OpenAPI的产品调用Java SDK均需要添加该依赖项,而aliyun-java-sdk-cdn包括了视频直播接口的Request和Response类。其中,恢复直播流推送的Request和Response类为ResumeLiveStreamRequest及ResumeLiveStreamResponse,Java代码示例如下:
public static void main(String[] args) throws Exception {
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessId, accessKey);
DefaultAcsClient client = new DefaultAcsClient(profile);
ResumeLiveStreamResponse res=ResumeLiveStreamR(client);
System.out.println(res.getRequestId());
}
static HttpResponse ForbidLiveStream(DefaultAcsClient client){
ForbidLiveStreamRequest request =new ForbidLiveStreamRequest();
request.setDomainName("<DomainName>");
request.setAppName("<AppName>");
request.setStreamName("<StreamName>");
request.setLiveStreamType("publisher");
HttpResponse response=null;
try {
response = client.doAction(request);
}catch (ServerException e) {
e.printStackTrace();
}
catch (ClientException e) {
e.printStackTrace();
}
return response;
}
Demo代码主要流程如下:
初始化Client对象。SDK需要通过IAcsClient对象完成对OpenAPI的调用,而初始化IAcsClient对象时根据IClientProfile对象配置region、AccessKeyId和AccessKeySecret参数。其中region请一直写cn-hangzhou,因为这里指的是OpenAPI的服务器所在区域。AccessKeyId和AccessKeySecret参数即是账号权限验证。如果是主账号的AccessKeyId和AccessKeySecret,则可以正常使用。如果是子账号的AccessKeyId和AccessKeySecret参数,则需要保证该子账号有视频直播的权限。
初始化请求Request类。SDK对每个接口实现了对应的Request类和Response类,对应的禁止推流Request类需要传入哪些参数,看API接口定义 恢复直播流推送API。
发起请求获取结果。使用Client对象的getAcsResponse方法发起Request对象请求,并根据该方法反馈的反序列化的结果实例化为对应接口的Response类。并且在执行该方法时可以catch ServerException和ClientException异常类,当http status>=300且<500 SDK抛ClientException,表示客户端错误。当http status>=500 SDK抛ServerException,表示服务器端错误。如果没有抛出异常则表示接口调用成功。
0.1元开启直播之旅
开年采购季,为了让更多用户能够体验和享受到视频直播云服务的便利,视频产品推出了0.1元体验包,配置清单如下:
点击了解活动详情
感谢你的阅读,关于视频直播,您还有什么问题?可以在文章末尾留言,我们会定期回复。