七牛---Pili直播推流SDK问题总结

详细的安装步骤可以参考:

http://developer.qiniu.com/article/pili/sdk/push-android.html#preparation

这里主要是将主Activity中的代码，因为官网文档上面已经描述的很详细了，所以以下只是做整理总结，整体思路就是先设置好各种参数配置，然后共同配置到CameraStreamingManager对象中，我们最新版的sdk分为4大类参数(CameraStreamingSetting对象，MicrophoneStreamingSetting对象，StreamingProfile对象以及WatermarkSetting对象)配置，可以看到设置如下:

mCameraStreamingManager.prepare(cameraStreamingSetting, microphoneStreamingSetting, watermarksetting, mStreamingProfile);

简单来说，首先要弄清楚CameraStreamingSetting对象和StreamingProfile对象的区别:

前者是和镜头预览相关的参数设置，主播可以看到镜头中自己的画面(包含前后置摄像头,清晰度,分辨率等参数配置)，而真正用来推流的配置参数是写在StreamingProfile对象中，这个是用来展示给观众看的画面，观众可以看到推出流的清晰度，画面分辨率等。另外两个对象MicrophoneStreamingSetting和WatermarkSetting对象比较简单，前者是用来设置开启蓝牙麦克风的，另外一个是用来设置推流水印的。

具体的各个参数设置情况可以参考:

package com.dxy.cloud.myapplication;
import android.app.Activity;
import android.hardware.Camera;
import android.opengl.GLSurfaceView;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
import com.pili.pldroid.streaming.CameraStreamingManager;
import com.pili.pldroid.streaming.CameraStreamingSetting;
import com.pili.pldroid.streaming.MicrophoneStreamingSetting;
import com.pili.pldroid.streaming.StreamStatusCallback;
import com.pili.pldroid.streaming.StreamingEnv;
import com.pili.pldroid.streaming.StreamingProfile;
import com.pili.pldroid.streaming.WatermarkSetting;
import com.pili.pldroid.streaming.widget.AspectFrameLayout;
import org.json.JSONException;
import org.json.JSONObject;
/**
* Created by dxy on 16/3/30.
*/
public class SWCameraStreamingActivity extends Activity implements CameraStreamingManager.StreamingStateListener, StreamStatusCallback {
private CameraStreamingManager mCameraStreamingManager;
private StreamingProfile mStreamingProfile;
private TextView mStreamStatus;
private Button torchBtn;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
StreamingEnv.init(getApplicationContext());
setContentView(R.layout.activity_swcamera_streaming);

//第一类-----------------------------------------------------------------
//----------------------------摄像头设置----------------------------
CameraStreamingSetting cameraStreamingSetting = new CameraStreamingSetting();
cameraStreamingSetting
//------------前后置镜头相关--------
//通过setCameraId可以指定使用前置摄像头或者是后置摄像头, CAMERA_FACING_FONT为前置, CAMERA_FACING_BACK为后置
.setCameraId(Camera.CameraInfo.CAMERA_FACING_BACK)
//-------------对焦相关----------
//通过setContinuousFocusModeEnabled设置自动对焦
.setContinuousFocusModeEnabled(true)
//通过setFocusMode设置对焦模式
/* FOCUS_MODE_CONTINUOUS_PICTURE 自动对焦(Picture);
FOCUS_MODE_CONTINUOUS_VIDEO   自动对焦(Video);
FOCUS_MODE_AUTO               手动对焦*/
.setFocusMode(CameraStreamingSetting.FOCUS_MODE_CONTINUOUS_VIDEO)
//--------------摄像头预览相关---------
//使用 PREVIEW_SIZE_LEVEL 和 PREVIEW_SIZE_RATIO 共同确定一个预览Size
//PREVIEW_SIZE_LEVEL和相机预览的清晰度有关系, 设置为SMALL预览的画面会很不清晰
/*
SDK 预定义的 preivew size level 列表：
CameraStreamingSetting.PREVIEW_SIZE_LEVEL.SMALL
CameraStreamingSetting.PREVIEW_SIZE_LEVEL.MEDIUM
CameraStreamingSetting.PREVIEW_SIZE_LEVEL.LARGE
SDK 预定义的 preview size ratio 列表：
CameraStreamingSetting.PREVIEW_SIZE_RATIO.RATIO_4_3
CameraStreamingSetting.PREVIEW_SIZE_RATIO.RATIO_16_9
*/
.setCameraPrvSizeLevel(CameraStreamingSetting.PREVIEW_SIZE_LEVEL.SMALL)
.setCameraPrvSizeRatio(CameraStreamingSetting.PREVIEW_SIZE_RATIO.RATIO_4_3)
//---------------RecordingHint提升数据源的帧率--------
//在部分机型开启 Recording Hint 之后，会出现画面卡帧等风险，所以请慎用该API。如果需要实现高 fps 推流，可以考虑开启并加入白名单机制
.setRecordingHint(false);

//第二类-----------------------------------------------------------------
//------------------------麦克风参数配置-----------------------------
MicrophoneStreamingSetting microphoneStreamingSetting = new MicrophoneStreamingSetting();
microphoneStreamingSetting
//希望增加蓝牙麦克风的支持,可以设置:
.setBluetoothSCOEnabled(true);

//第三类-----------------------------------------------------------------
//------------------------推流参数设置-------------------------------
mStreamingProfile = new StreamingProfile();

//从MainActivity获取传入的推流的JSON数据
String streamJsonStrFromServer = getIntent().getStringExtra("stream_json_str");
showToast(streamJsonStrFromServer);
JSONObject streamJson = null;
try {
streamJson = new JSONObject(streamJsonStrFromServer);
} catch (JSONException e) {
e.printStackTrace();
}

mStreamingProfile
//------------------通过setStream设置推流地址----------------
.setStream(new StreamingProfile.Stream(streamJson))
//-----------------通过setVideoQuality设置推流视频部分质量参数------------
/*
Level   Fps Video Bitrate(Kbps)
VIDEO_QUALITY_LOW1 12 150
VIDEO_QUALITY_LOW2  15  264
VIDEO_QUALITY_LOW3  15  350
VIDEO_QUALITY_MEDIUM1 30 512
VIDEO_QUALITY_MEDIUM2   30  800
VIDEO_QUALITY_MEDIUM3   30  1000
VIDEO_QUALITY_HIGH1 30  1200
VIDEO_QUALITY_HIGH2 30  1500
VIDEO_QUALITY_HIGH3 30  2000
*/
.setVideoQuality(StreamingProfile.VIDEO_QUALITY_MEDIUM2)

//-----------------通过setAudioQuality设置推流音频部分质量参数------------
/*
Level   Audio Bitrate(Kbps) Audio Sample Rate(Hz)
AUDIO_QUALITY_LOW1  18  44100
AUDIO_QUALITY_LOW2  24  44100
AUDIO_QUALITY_MEDIUM1   32  44100
AUDIO_QUALITY_MEDIUM2   48  44100
AUDIO_QUALITY_HIGH1 96  44100
AUDIO_QUALITY_HIGH2 128 44100
*/
.setAudioQuality(StreamingProfile.AUDIO_QUALITY_MEDIUM2)

//--------------通过AVProfile参数自定义推流音视频码率帧率--------------------
// 自定义设置音频采样率为44100Hz, 码率为96 * 1024 bps
// 自定义设置视频帧率为30, 码率为1000 * 1024 bps,最大帧率为48
//setAVProfile 的优先级高于 Quality，也就是说，当同时调用了 Quality 和 AVProfile 的设置，AVProfile 会覆盖 Quality 的设置值
.setAVProfile(new StreamingProfile.AVProfile(new StreamingProfile.VideoProfile(30, 1000 * 1024, 48), new StreamingProfile.AudioProfile(44100, 96 * 1024)))
//--------------通过setEncoderRCMode设置质量优先还是码率优先----------------
//EncoderRCModes.QUALITY_PRIORITY: 质量优先，实际的码率可能高于设置的码率
//EncoderRCModes.BITRATE_PRIORITY: 码率优先，更精确地码率控制
//默认值为 EncoderRCModes.QUALITY_PRIORITY
.setEncoderRCMode(StreamingProfile.EncoderRCModes.BITRATE_PRIORITY)

//---------------设置推流的分辨率-------------------------------------------
/*
Level              Resolution(16:9) Resolution(4:3)
VIDEO_ENCODING_HEIGHT_240   424 x 240   320 x 240
VIDEO_ENCODING_HEIGHT_480   848 x 480   640 x 480
VIDEO_ENCODING_HEIGHT_544   960 x 544   720 x 544
VIDEO_ENCODING_HEIGHT_720   1280 x 720  960 x 720
VIDEO_ENCODING_HEIGHT_1088  1920 x 1088 1440 x 1088
*/
.setEncodingSizeLevel(StreamingProfile.VIDEO_ENCODING_HEIGHT_720)
//自定义设置推流分辨率，此优先级高于setEncodingSizeLevel
.setPreferredVideoEncodingSize(1000, 1000)

//-------------------设置推流播放端方向-------------------------------
//设置ENCODING_ORIENTATION.LAND推流播放端会横屏播放
//设置ENCODING_ORIENTATION.PORT推流播放端会竖屏播放
.setEncodingOrientation(StreamingProfile.ENCODING_ORIENTATION.LAND);

//第四类-----------------------------------------------------------------
//------------------------水印参数设置-------------------------------
//第二个参数设置水印图片，可以传入本地drawable中的图片，也可以传入图片的绝对路径作为水印资源
//第三个参数设置水印的位置
//第四个参数设置水印显示的大小
WatermarkSetting watermarksetting = new WatermarkSetting(this, R.drawable.qiniu_logo, WatermarkSetting.WATERMARK_LOCATION.SOUTH_WEST, WatermarkSetting.WATERMARK_SIZE.MEDIUM, 100);

//------------------------------------------------------------------------------
//---------------通过CameraStreamingManager类将以上信息传入------------------------

AspectFrameLayout afl = (AspectFrameLayout) findViewById(R.id.cameraPreview_afl);
GLSurfaceView glSurfaceView = (GLSurfaceView) findViewById(R.id.cameraPreview_surfaceView);
//SHOW_MODE.FULL，可以全屏显示（没有黑边），但是预览的图像和播放的效果有出入,即之前的黑边部分其实没有推流
//SHOW_MODE.REAL，所见即所得
afl.setShowMode(AspectFrameLayout.SHOW_MODE.REAL);

//构造带有视频 CameraStremaingManager,需要传入AspectFrameLayout和GLSurfaceView,第四个参数设置编码的方式，硬编or软编
mCameraStreamingManager = new CameraStreamingManager(this, afl, glSurfaceView, CameraStreamingManager.EncodingType.SW_VIDEO_WITH_SW_AUDIO_CODEC);
mCameraStreamingManager.prepare(cameraStreamingSetting, microphoneStreamingSetting, watermarksetting, mStreamingProfile);

//-------动态更改推流播放端方向---------------------------------------
//        boolean isEncOrientationPort = false;
//        setRequestedOrientation(isEncOrientationPort ? ActivityInfo.SCREEN_ORIENTATION_PORTRAIT : ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
//        mCameraStreamingManager.notifyActivityOrientationChanged();

//-----------注册各种Listener----------------------------------------
//流状态改变回调监听:
//推流状态回调监听,比如流断开,重连回调
mCameraStreamingManager.setStreamingStateListener(this);
//实现StreamStatusCallback 接口的
mCameraStreamingManager.setStreamStatusCallback(this);
//        //可以在 StreamingSessionListener 处理一些重连、音频读取失败、preview size 的自定义操作。
//        mCameraStreamingManager.setStreamingSessionListener((CameraStreamingManager.StreamingSessionListener) this);

//推流状态信息回调mStreamStatus初始化
mStreamStatus = (TextView) findViewById(R.id.stream_status);

//--------------其他的一些功能----------------------------------
//--------------闪光灯----------------------------------------
//初始化闪光灯按钮
torchBtn = (Button) findViewById(R.id.torch_btn);
//闪光灯监听
torchBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
new Thread(new Runnable() {
@Override
public void run() {

}
}).start();
}
});

//-----------------禁音推流--------------------------------------
//设置为true为禁止声音推流,默认为falase
//mCameraStreamingManager.mute(true);
mCameraStreamingManager.mute(false);

//        mCameraStreamingManager.captureFrame(200, 200, new FrameCapturedCallback() {
//            @Override
//            public void onFrameCaptured(Bitmap bmp) {
//
//            }
//        }

}

void showToast(final String msg) {
this.runOnUiThread(new Runnable() {
@Override
public void run() {
Toast.makeText(SWCameraStreamingActivity.this, msg, Toast.LENGTH_LONG).show();
}
});
}

//推流过程中流状态信息的一些回调
@Override
public void onStateChanged(int state, Object info) {
switch (state) {
case CameraStreamingManager.STATE.PREPARING:
showToast("STATE.PREPARING");
break;
case CameraStreamingManager.STATE.READY:
// 当流的状态是READY的时候开始推流
new Thread(new Runnable() {
@Override
public void run() {
if (mCameraStreamingManager != null) {
mCameraStreamingManager.startStreaming();
}
}
}).start();
showToast("STATE.READY");
break;
case CameraStreamingManager.STATE.CONNECTING:

showToast("STATE.CONNECTING");
break;
case CameraStreamingManager.STATE.STREAMING:

showToast("STATE.STREAMING");
break;
case CameraStreamingManager.STATE.SHUTDOWN:

showToast("STATE.SHUTDOWN");
break;
//若网络不可达（网络断开等情况），尝试重连之后，会返回 STATE.IOERROR，可以不用担心循环重连的问题。
//在网络层会有三次重连的机会，即没有必要在收到 STATE.IOERROR 之后继续进行重连，一般接收到 STATE.IOERROR 代表无法通过网络和服务端建立链接。
case CameraStreamingManager.STATE.IOERROR:
showToast("STATE.IOERROR");
break;
case CameraStreamingManager.STATE.UNKNOWN:

showToast("STATE.UNKNOWN");
break;
case CameraStreamingManager.STATE.SENDING_BUFFER_EMPTY:

showToast("STATE.SENDING_BUFFER_EMPTY");
break;
case CameraStreamingManager.STATE.SENDING_BUFFER_FULL:

showToast("STATE.SENDING_BUFFER_FULL");
break;
case CameraStreamingManager.STATE.AUDIO_RECORDING_FAIL:

showToast("STATE.AUDIO_RECORDING_FAIL");
break;
case CameraStreamingManager.STATE.OPEN_CAMERA_FAIL:

showToast("STATE.OPEN_CAMERA_FAIL");
break;
//在网络断开、sendTimeOut 后没有发出数据、网络链接被服务端断开等网络异常后，STATE.DISCONNECTED 消息会被回调
case CameraStreamingManager.STATE.DISCONNECTED:

showToast("STATE.DISCONNECTED");
break;
}
}

@Override
public boolean onStateHandled(int i, Object o) {
return false;
}

//推流状态信息
@Override
public void notifyStreamStatusChanged(final StreamingProfile.StreamStatus streamStatus) {
runOnUiThread(new Runnable() {
@Override
public void run() {
mStreamStatus.setText("bitrate:" + streamStatus.totalAVBitrate / 1024 + " kbps"
+ "\naudio:" + streamStatus.audioFps + " fps"
+ "\nvideo:" + streamStatus.videoFps + " fps");
}
});
}

@Override
protected void onResume() {
super.onResume();
mCameraStreamingManager.onResume();
}

@Override
protected void onPause() {
super.onPause();
mCameraStreamingManager.onPause();
}

@Override
protected void onDestroy() {
super.onDestroy();
mCameraStreamingManager.onDestroy();
}
}