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);
}