Android 推流SDK使用说明__SDK文档及下载_API及SDK_视频直播-阿里云

4） 错误事件通知中：

private OnLiveRecordErrorListener mOnErrorListener = new OnLiveRecordErrorListener() {
    @Override
    public void onError(int errorCode) {
        switch (errorCode) {
            case AlivcStatusCode.ERROR_SERVER_CLOSED_CONNECTION:
            case AlivcStatusCode.ERORR_OUT_OF_MEMORY:
            case AlivcStatusCode.ERROR_CONNECTION_TIMEOUT:
            case AlivcStatusCode.ERROR_BROKEN_PIPE:
            case AlivcStatusCode.ERROR_ILLEGAL_ARGUMENT:
            case AlivcStatusCode.ERROR_IO:
            case AlivcStatusCode.ERROR_NETWORK_UNREACHABLE:
                Log.i(TAG, "Live stream connection error-->" + errorCode);
                ToastUtils.showToast(LiveCameraActivity.this,"Live stream connection error-->" + errorCode);
                 break;
             default:
        }
    }
};

4.接口说明

SDK中提供了两个类AlivcMediaRecorder和AlivcMediaRecorderFactory，其中AlivcMediaRecorder是推流SDK使用接口类，AlivcMediaRecorderFactory用来创建推流器器AlivcMediaRecorder。同时提供了多个事件通知接口，用来监听推流器的各种状态。

4.1 AlivcMediaRecorderFactory

类名：AlivcMediaRecorderFactory

功能：创建推流器接口AlivcMediaRecorder

成员：

详细说明：

AlivcMediaRecorderFactory.createMediaRecorder()

createMediaRecorder用来创建推流器，返回AlivcMediaRecorder类。

参数:

空

返回值：返回空为错误，正确则为有效的AlivcMediaRecorder值。

4.2 AlivcMediaRecorder

类名：AlivcMediaRecorder

功能：推流器接口类AlivcMediaRecorder，提供推流控制

成员：

下面详细介绍一下各个成员函数的具体使用：

• 1.初始化推流器

/**
 * @param context：Android上下文
 */
void init(Context context);

• 2.开始预览

/**
 * 开始预览
 * @param  params: 推流过程中不可动态改变的参数.
 * @param  surface: 预览窗口
 */
 void prepare(Map<String, Object> params, Surface surface);

• 3.开始推流

/**
 * @param outputUrl 推流地址URL
 */
 void startRecord(String outputUrl);

备注：在prepare完成之后调用startRecord进行推流。

• 4.结束推流

void stopRecord();

• 5.切换摄像头

void switchCamera();

• 6.释放资源

void reset();

备注：释放预览资源,对应的是prepare

• 1. 手动对焦

/**
 * @param xRatio 横向坐标点所占的比例
 * @param yRatio 纵向坐标点所占的比例
 */
void focusing(float xRatio, float yRatio);

• 8.缩放

/**
 * 这是个新增加的接口，老接口为下面的接口，已经废弃，不建议使用
 *
 * @param scaleFactor参数为缩放比例
 */
void setZoom(float scaleFactor);

/**
 * 这个接口已经废弃了，建议使用上面的接口
 *
 * @param scaleFactor参数为缩放比例
 */
@Deceperated
void setZoom(float scaleFactor,CaptureRequest.OnCaptureRequestResultListener listener);

• 9.设置预览大小

/**
 * @param width 预览宽
 * @param height 预览高
 */
void setPreviewSize(int width, int height);

• 10.开启美颜／开启手动对焦／开启闪光灯／开启静音推流

/**
 * 增加效果 如：美颜，对焦，闪光灯，静音等
 * @see AlivcMediaFormat#FLAG_BEAUTY_ON
 * @see AlivcMediaFormat#FLAG_AUTO_FOCUS_ON
 * @see AlivcMediaFormat#FLAG_FLASH_MODE_ON
 * @see AlivcMediaFormat#FLAG_MUTE_ON
 * @see AlivcMediaRecorder#removeFlag(int)
 * @param flag
 */
void addFlag(int flag);

• 11.关闭美颜／关闭手动对焦／关闭闪光灯／关闭静音推流

/**
 * 移除效果 如：美颜，对焦，闪光灯，静音等
 * @see AlivcMediaFormat#FLAG_BEAUTY_ON
 * @see AlivcMediaFormat#FLAG_AUTO_FOCUS_ON
 * @see AlivcMediaFormat#FLAG_FLASH_MODE_ON
 * @see AlivcMediaFormat#FLAG_MUTE_ON
 * @param flag
 */
void removeFlag(int flag);

• 12.释放资源

void release();

• 13.设置推流错误回调

/**
 * @param listener 直播错误回调
 */
void setOnRecordErrorListener(OnLiveRecordErrorListener listener);

备注：具体的错误信息会在下面介绍

• 14.设置推流的状态回调监听

/**
 * @param listener 直播状态回调
 */
void setOnRecordStatusListener(OnRecordStatusListener listener);

备注：回调具体的信息在下面介绍

• 15.设置网络状态的回调监听

/**
 * @param listener 直播网络状态回调
 */
void setOnNetworkStatusListener(OnNetworkStatusListener listener);

备注：回调具体的信息在下面介绍

• 16.添加水印图片

首先需要创建一个水印信息对像——AlivcWatermark

AlivcWatermark mWatermark = new AlivcWatermark.Builder()
                    .watermarkUrl(bundle.getString(WATERMARK_PATH)) //水印图片地址
                    .paddingX(bundle.getInt(WATERMARK_DX))                 //水印图片在x轴的偏移
                    .paddingY(bundle.getInt(WATERMARK_DY))                 //水印图片在y轴的偏移
                    .site(bundle.getInt(WATERMARK_SITE))                        //水印图片位置
                    .build();

水印位置有四个常量表示：

然后需要将该水印信息描述对像通过AlivcMediaRecorder#prepare接口的map参数传入进去

mConfigure.put(AlivcMediaFormat.KEY_WATERMARK, mWatermark); //配置水印信息
......
mMediaRecorder.prepare(mConfigure, mPreviewSurface);

• 17.获取SDK版本名称

String getVersionName()

4.3 OnNetworkStatusListener

当调用startRecord()后，推流器开始推流，当前的网络连接状态会返回，用户需要注册该事件,以便获取到该时间通知，在结束和开始的状态都会给予返回.

public interface OnNetworkStatusListener {
  /**
   * 网络较差时的回调，此时推流buffer为满的状态，会执行丢包，此时数据流不能正常推送
   */
  void onNetworkBusy();
  /**
   * 网络空闲状态，此时本地推流buffer不满，数据流可正常发送
   */
  void onNetworkFree();
  /**
   * @param   status
   */
  void onConnectionStatusChange(int status);
  /**
   * 重连失败
   * @return false:停止重连 true:继续重连
   * 说明: ｓｄｋ检测到检测到需要重连时将会自动执行重连，直到重连成功或者重连尝试超时，
   * 超时时间可以通过{@link AlivcMediaFormat#KEY_RECONNECT_TIMEOUT}来设置，
   * 默认为５ｓ，超时后将触发此回调，若返回true表示继续开始新的一轮尝试，返回false，
   * 表示不再尝试
   */
  boolean onNetworkReconnectFailed();
}

public interface OnRecordStatusListener {
    /*** 摄像头打开成功   */
    void onDeviceAttach();
    /*** 开启预览成功   */
    void onSessionAttach();
    /**   * 停止预览   */
    void onSessionDetach();
    /*** 关闭摄像头   */
    void onDeviceDetach();
    /**摄像头打开失败**/
    void onDeviceAttachFailed(int facing)
}

public interface OnLiveRecordErrorListener {
    /**
     * @param  errorCode 获取到的错误类型Code
     * @see AlivcStatusCode#ERROR_**
     */
    void onError(int errorCode);
}