之前发布过一行代码实现安卓屏幕采集编码,并介绍了如何屏幕采集编码并进行了封装,简单的调用即可实现MediaProjection权限申请、H264硬编码、错误处理等功能。本文将介绍新增的功能,还是只需一行代码即可实现屏幕、声音采集。
一行代码实现屏幕采集编码
之前的文章,我们已经介绍过如何一行代码实现安卓屏幕采集编码,这里再次简单介绍一下
ScreenShareKit.init(this).onH264({ buffer, isKeyFrame, w, h, ts ->
//获取编码后的屏幕内容数据
}).onStart({
//用户同意采集,开始采集数据
}).start()
通过这段代码,我们可以实现MediaProjection权限申请、H264硬编码、错误处理等功能。同时,我们也新增了一个onStart回调,会在用户同意屏幕采集后回调该方法,更加方便的处理业务。
增加全局屏幕旋转监测
在之前版本中,屏幕旋转,会导致画面变形,宽高错乱。本次更新中,屏幕旋转监测是通过反射监听IRotationWatcher来实现的。IRotationWatcher是一个AIDL接口,它定义了一个旋转监测器,用于监测屏幕旋转事件。在ScreenShare库中,我们通过反射获取IRotationWatcher对象,并注册一个IRotationWatcher.Stub实例来监听屏幕旋转事件。当屏幕旋转时,该Stub实例会收到回调,并根据旋转角度重置编码器,更改宽高,以保证屏幕方向正确。这里不是简单判断设备是否旋转,而是判断屏幕内容或者其他app布局是否旋转。然后重置编码器,更改宽高。始终保持方向正确。
参考:scrcpy
增加RGBA数据回调
由于Android设备多,各类 CPU 性能不一。很难保证每个设备硬编码后都能够清晰流畅。所以新增一种方式,使用ImageReader采集屏幕截图,有很多开源库截图都是利用这个类。ImageReader是Android系统提供的一个用于获取屏幕截图的类,通过setOnImageAvailableListener回调,能够不停地获取屏幕变化,并获取RGBA数据。在这里我们通过创建一个ImageReader对象,并设置其宽高、像素格式等参数来获取屏幕数据。在回调函数中,我们可以获取到每一帧的RGBA数据,并进行处理。该实现虽然比硬编码占用的内存高一点,但优势在于非常的均衡,无论性能强悍或是低端的CPU,都能够得到画质较清晰流畅的数据。
ScreenShareKit.init(this).config(screenDataType = EncodeBuilder.SCREEN_DATA_TYPE.RGBA).onRGBA(object : RGBACallBack {
override fun onRGBA(
rgba: ByteArray,
width: Int,
height: Int,
stride: Int,
rotation: Int,
rotationChanged: Boolean
) {
//采集的RGBA数据
}
}).onStart({
//用户同意采集,开始采集数据
}).start()
增加屏幕内置声音采集回调
Android 10已引入AudioPlaybackCapture API。应用可以借助此API复制其他应用正在播放的音频。此功能类似于屏幕采集,但采集对象是音频。主要用例是视频在线播放应用,这些应用希望捕获游戏正在播放的音频。
AudioPlaybackCaptureConfiguration config = (new AudioPlaybackCaptureConfiguration.Builder(mediaProjection)).addMatchingUsage(AudioAttributes.USAGE_MEDIA).build();
AudioFormat audioFormat = (new AudioFormat.Builder()).setEncoding(AudioFormat.ENCODING_PCM_16BIT).setSampleRate(sampleRate).setChannelMask(channelConfig).build();
audioRecord = new AudioRecord.Builder().setAudioFormat(audioFormat).setBufferSizeInBytes(bufferSizeInBytes).setAudioPlaybackCaptureConfig(config).build();
**注意:**应用的音频能否被捕获也取决于应用的 targetSdkVersion
。
- 仅支持Android 10及以上版本
- 默认情况下,适配Android 9.0及之前版本的应用不允许捕获播放的音频。如要启用该功能,请在应用的
manifest.xml
文件中包含android:allowAudioPlaybackCapture="true"
。 - 默认情况下,适配Android 10 (API级别29)或更高版本的应用允许其他应用捕获其音频。如要停用“捕获播放的音频”功能,请在应用的
manifest.xml
文件中包含android:allowAudioPlaybackCapture="false"
。
使用:
ScreenShareKit.init(this).config(audioCapture = true).onAudio(object : AudioCallBack {
override fun onAudio(buffer: ByteArray?, ts: Long) {
//应用的音频数据
}
}).onStart({
//用户同意采集,开始采集数据
}).start()
参考捕获播放的音频:官方文档
增加禁音屏幕内置声音方法
在应用采集过程中,如果不想中断又想禁音,可以调用以下方法。
ScreenShareKit.setMicrophoneMute(true)
设置为true之后,将会回调空数据,已达到静音效果。反正,恢复正常音频采集。
以上就是本文介绍的一些实用功能。通过这个库,我们可以通过简单的一行代码实现屏幕、声音采集,并且支持全局屏幕旋转监测、RGBA数据回调、屏幕内置声音采集等功能。这个库使用起来非常方便,项目地址:ScreenShare