title: LocalStream

用户设备采集的本地媒体流。全局单例,通过 create() 方法创建本地媒体流之后,可以通过 getInstance() 方法多次获取本地媒体流实例。



isClosed()

定义

  1. boolean isClosed()

说明

判断当前视频流是否已经关闭,如果没有关闭,可以关闭,并且释放占用资源。



方法

create(options)

定义

  1. public static LocalStream create(LocalStreamOptions options)

说明

创建本地媒体流。

参数

参数名 描述
options 本地媒体流创建配置参数,可以使用默认值进行创建。请参考:LocalStreamOptions

返回值

LocalStream 实例对象。

示例

  1. LocalStreamOptions options = new LocalStreamOptions.Builder().build();
  2. LocalStream localStream = LocalStream.create(options);



getInstance()

定义

  1. public static LocalStream getInstance()

说明

获取已创建的本地媒体流实例对象。

注意:此方法必须在create() 方法调用后使用,如当前未调用 create() 方法进行创建则抛出 NullPointerException 异常。

返回值

LocalStream 实例对象。

示例

  1. localStream = LocalStream.getInstance();



setOnFrameListener()

定义

  1. public void setOnFrameListener(CameraFrameListener listener)

说明

设置相机帧数据获取接口,在回调方法中可以获取视频流的帧数据(目前帧数据格式为 NV21 格式的 byte 数组 )。

参数

参数名 描述
listener 相机帧数据获取接口,请参考:CameraFrameListener

示例

  1. localStream.setOnFrameListener(new LocalStream.CameraFrameListener() {
  2. @Override
  3. public void onByteFrame(byte[] bytes, int width, int height) {
  4. //处理帧数据的方法
  5. //frameProcess(bytes);
  6. }
  7. });



switchCamera()

定义

  1. public void switchCamera()

说明

用于前后置摄像头切换。

示例

  1. localStream.switchCamera();



capturePicture(listener, isMirroring)

定义

  1. public void capturePicture(CompleteListener listener, boolean isMirroring)

说明

实现对本地流的拍照功能。

参数

参数名 描述
listener 拍照完成回调接口。
isMirroring localview 是否设置了镜像。



setFlashMode(flashMode)

定义

  1. public void setFlashMode(FlashMode flashMode)

说明

设置闪光灯模式。

参数

参数名 描述
flashMode 设置闪光灯模式,默认关闭。



setAudioBufferListener(listener)

定义

  1. public void setAudioBufferListener(AudioBufferListener listener)

说明

设置本地音频流回调,回调方法中获得本地音频数据。

参数

参数名 描述
listener 本地音频流回调接口。



removeAudioBufferListener()

定义

  1. public void removeAudioBufferListener()

说明

移除本地音频流回调监听。



attach(videoView)

定义

  1. public void attach(WilddogVideoView videoView)

说明

在指定的 WilddogVideoView 中显示媒体流。

参数

参数名 描述
videoView 请参考:WilddogVideoView



detach()

定义

  1. public void detach()

说明

解除媒体流与 WilddogVideoView 的绑定,停止播放。

参数

参数名 描述
videoView 请参考:WilddogVideoView



close()

定义

  1. void close()

说明

关闭本地流,释放占用资源。

示例

  1. localStream.close();