API接口

屏幕录制SDK以SDInterfaceScreenPublishService这个Service服务形式对外提供屏幕录制、麦克风采集服务。
外层需负责：服务到AndroidManifest的注册、相关权限的申请、MediaProjection对VirtualDisplay的获取、省电白名单的加入，这部分可以参考DEMO源码实现。

Android屏幕采集较为繁琐，本SDK极大简化了用户的调用工作。

1、准备启动service所需的Intent

mIntentForService.putExtra("SERVER_IP", serverIp);
mIntentForService.putExtra("ROOM_ID", roomId);
mIntentForService.putExtra("UP_POSITION", upPosition);
mIntentForService.putExtra("ENABLE_AUDIO", ENABLE_AUDIO_CAP);

mIntentForService.putExtra("ENCODE_VIDEO_WIDTH", width);
mIntentForService.putExtra("ENCODE_VIDEO_HEIGHT", height);
mIntentForService.putExtra("ENCODE_VIDEO_FRAMERATE",framerate);
mIntentForService.putExtra("ENCODE_VIDEO_BITRATE", bitrate);
mIntentForService.putExtra("ENCODE_VIDEO_USEHW", useHardwareEnc);

mIntentForService.putExtra("ENCODE_AUDIO_SAMPLERATE", sampleRate);
mIntentForService.putExtra("ENCODE_AUDIO_CHANNELS", channelCount);

参数：
@ SERVER_IP，指定服务器IP地址
@ROOM_ID，指定发布的房间号（非0值，与播放端约定）。
@UP_POSITION，指定发布到房间中的哪一个“位置”。
@ENABLE_AUDIO，是否发布音频流
@ENCODE_VIDEO_WIDTH，发布视频流的宽度，比如1920
@ENCODE_VIDEO_HEIGHT，发布视频流的高度，比如1080
@ENCODE_VIDEO_FRAMERATE，发布视频流的帧率，当设置的帧率超过30fps时，内部将使用高帧率模式，码率波动加剧。
@ENCODE_VIDEO_BITRATE，发布视频流的码率，注意其单位为bps
@ENCODE_VIDEO_USEHW，是否使用视频硬编码，因为屏幕共享分辨率往往较高，建议使用硬编码以保证性能。
@ENCODE_AUDIO_SAMPLERATE，发布音频流的采样率，比如44100
@ENCODE_AUDIO_CHANNELS，发布音频流的声道数，比如2即双声道立体声。

2、准备绑定service所需的ServiceConnection

我们通过bind服务，实现对服务API的直接调用。目前服务对外提供2个API，分别为：

（1）void setScreenCapStatusCallback(ScreenCapStatusCallback callback)

设置屏幕录制服务的状态回调，状态回调包括三种状态:OnStart、OnRecording、OnStop，其中前两者可用于外层的界面展示更新，比如展示已共享的时长。OnStop则用于通知外层需结束服务，此时一般发生了内部错误。

（2）void setScreenCapSource(VirtualDisplay virtualDisplay)

设置屏幕录制源VirtualDisplay，该录制源由外层通过MediaProjection系统API获得。

3、绑定并启动服务

调用Android系统API绑定并启动服务，注意二者顺序不能错误，即先绑定后启动。

bindService(mIntentForService,  mServiceConnection,  Context.BIND_AUTO_CREATE);
startService(mIntentForService);

4、结束并解除绑定服务

调用Android系统API结束服务并解除绑定。

stopService(mIntentForService);
unbindService(mServiceConnection);

结束服务有两种情况下触发，第一种是用户UI操作结束分享；第二种是分享失败，服务内部申请结束，此时将通过回调OnStop接口触发。