使用EasyPusher SDK进行便捷开发

基于EasyPusher sdk库工程(即library module)实现一个推送客户端非常简单便捷,因为sdk端已经将各种烦人的状态维护\错误检查\权限判定\UI同步等功能都实现了,开发者仅仅只需要实现若干接口即可.

让我们看看如何实现一个Pusher吧!

首先我们介绍一下Pusher sdk的封装用到了哪些技术.

  1. Android Architecture Components

Android architecture components是Google 官方出的一个Android APP的开发标准与指南.其官方介绍文档如下:

A collection of libraries that help you design robust, testable, and maintainable apps. Start with classes for managing your UI component lifecycle and handling data persistence.

基于这个AAC库,Pusher 的sdk的封装做了两件事情:

  • 在底层可以捕获到上层Activity\Fragment的生命周期,从而自己管理自己的状态,包括初始化\启动\停止\反初始化等工作.这样,上层就轻松多了.
  • 使用LiveData保存维护自己的一些状态,上层可以方便通过注册LiveData,来获取到当前的状态,以及获取到状态变更的回调.

    1. Reactivestreams

reactive streams 即响应式编程,是一种基于”数据流和变化传播的编程范式”,更多的介绍见ReactiveX.pusher的library层一些接口基于Reactivestreams实现,这样很方便上层使用rxjava等库进行开发.

好了,我们看看如何基于library库实现一个pusher吧.sdk主要功能在MediaStream里实现,这个类是一个服务类.

  1. 启动服务:
// 启动服务...
Intent intent = new Intent(this, MediaStream.class);
startService(intent);
  1. 获取MediaStream对象.由于MediaStream是个服务,所以我们无法直接创建其对象,只能通过binder来绑定.这个过程是异步的.sdk内部对这个过程进行了封装,返回一个publisher,我们可以观察这个publisher来获取到MediaStream的对象.上层代码如下:

    // (异步)获取MediaStream对象
    private Single<MediaStream> getMediaStream() {
     Single<MediaStream> single = RxHelper.single(MediaStream.getBindedMediaStream(this, this), mediaStream);
     if (mediaStream == null) {
     return single.doOnSuccess(new Consumer<MediaStream>() {
     @Override
     public void accept(MediaStream ms) throws Exception {
     mediaStream = ms;
     }
     });
     } else {
     return single;
     }
    }
  2. 观察MediaStream内部状态更改并更新UI:

    final TextView pushingStateText = findViewById(R.id.pushing_state);
    final TextView pushingBtn = findViewById(R.id.pushing);
    ms.observePushingState(MainActivity.this, new Observer<MediaStream.PushingState>() {
    
     @Override
     public void onChanged(@Nullable MediaStream.PushingState pushingState) {
       if (pushingState.screenPushing) {
         pushingStateText.setText("屏幕推送");
    
         // 更改屏幕推送按钮状态.
    
         TextView tview = findViewById(R.id.pushing_desktop);
         if (pushingState.state > 0) {
           tview.setText("取消推送");
         } else {
           tview.setText("推送屏幕");
         }
         findViewById(R.id.pushing_desktop).setEnabled(true);
       } else {
         pushingStateText.setText("推送");
    
         if (pushingState.state > 0) {
           pushingBtn.setText("停止");
         } else {
           pushingBtn.setText("推送");
         }
    
       }
       pushingStateText.append(":\t" + pushingState.msg);
       if (pushingState.state > 0) {
         pushingStateText.append(pushingState.url);
       }
    
     }
    });

  3. 设置或者关闭摄像头View.

    TextureView textureView = findViewById(R.id.texture_view);
    textureView.setSurfaceTextureListener(new SurfaceTextureListenerWrapper() {
     @Override
     public void onSurfaceTextureAvailable(SurfaceTexture surfaceTexture, int i, int i1) {
       ms.setSurfaceTexture(surfaceTexture);
     }
     @Override
     public boolean onSurfaceTextureDestroyed(SurfaceTexture surfaceTexture) {
       ms.setSurfaceTexture(null);
       return true;
     }
    });
    
  4. 尝试申请权限,并在权限获取到后,告知SDK.

    
    if (ActivityCompat.checkSelfPermission(MainActivity.this, android.Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED ||
       ActivityCompat.checkSelfPermission(MainActivity.this, android.Manifest.permission.RECORD_AUDIO) != PackageManager.PERMISSION_GRANTED) {
     ActivityCompat.requestPermissions(MainActivity.this, new String[]{android.Manifest.permission.CAMERA, android.Manifest.permission.RECORD_AUDIO}, REQUEST_CAMERA_PERMISSION);
    }
    mediaStream.notifyPermissionGranted();
  5. 打开摄像头并预览.

    mediaStream.openCameraPreview();
  6. 启动推送

    mediaStream.startStream("cloud.easydarwin.org", "554", id);
  7. 停止推送

    mediaStream.stopStream();
  8. 停止预览

    mediaStream.closeCameraPreview();
  9. 退出

    // 终止服务...
    Intent intent = new Intent(this, MediaStream.class);
    stopService(intent);

以上代码就是一个启动推送\退出的过程,注意,其中包括了摄像头权限申请,推送状态回调,摄像头预览界面设置,界面关闭时自动释放,Activity recreate处理等等许多隐性工作..这些工作看似不是SDK主要的工作,但是作为一个稳定的APP却必须十分小心地处理,我们必须慎之又慎才能处理好这些隐性工作.而通常处理的过程中会使得我们的逻辑变得异常复杂,导致bug频繁.

以上相关代码都可以在EasyPusher的library分支的demo里面看到.地址:

https://github.com/EasyDSS/EasyPusher-Android/tree/library

除此之外,sdk还支持摄像头切换\录像\UVC摄像头推送等功能.将会在别的文章进行介绍.

## 获取更多信息 ##

邮件:[email protected]

EasyDarwin开源流媒体服务器:www.EasyDarwin.org

EasyDSS商用流媒体解决方案:www.EasyDSS.com

EasyNVR无插件直播方案:www.EasyNVR.com

Copyright © EasyDarwin Team 2012-2017

EasyDarwin

猜你喜欢

转载自blog.csdn.net/jyt0551/article/details/78896158

相关文章