直播推流初始化设置

要进行直播推流，您必须开启直播加速 > 配置直播域名 > 直播推流，详情参考快速开始。

如何获取推流地址

直播加速配置成功后，您可以通过以下方式获取对应的推流地址。

登录视频直播控制台。

单击域名管理。
选择所需地域。
选择所需的域名。
选择所需域名，并单击右侧的管理。
在基本信息中，获取对应的推流地址：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 推流。

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，表示服务器端错误。如果没有抛出异常则表示接口调用成功。