java.lang.Object
- com.videogo.openapi.EZPlayer

所有已实现的接口:

com.ez.player.EZMediaPlayer.OnCompletionListener, com.ez.player.EZMediaPlayer.OnErrorListener, com.ez.player.EZMediaPlayer.OnInfoListener
```
public class EZPlayer
extends java.lang.Object
implements com.ez.player.EZMediaPlayer.OnCompletionListener, com.ez.player.EZMediaPlayer.OnErrorListener, com.ez.player.EZMediaPlayer.OnInfoListener
```
播放器接口主类，预览和对讲可以共用一个EZPlayer对象，也可以不共用，预览和回放建议使用不同的EZPlayer对象

构造器概要

构造器
构造器	说明
`EZPlayer()`
`EZPlayer(int userId, int cameraNo, int streamType)`
`EZPlayer(EZStreamParamHelp paramHelp)`	摄像机预览、回放、对讲时使用此构造函数。
`EZPlayer(java.lang.String url)`	通过URL播放时使用此构造函数。

方法概要

所有方法实例方法具体方法已过时的方法
修饰符和类型	方法	说明
`android.graphics.Bitmap`	`capturePicture()`	开启截屏，需要先开启预览或回放
`int`	`capturePicture(java.lang.String fileNameWithPath)`	开启截屏，需要先开启预览或回放
`boolean`	`closeSound()`	关闭声音
`void`	`closeVoiceTalkMicrophone()`	关闭本地麦克风采集
`void`	`getLeaveMessageData(EZLeaveMessage msg, EZOpenSDKListener.EZLeaveMessageFlowCallback leaveMessageFlowCallback)`	获取留言数据
`java.util.Calendar`	`getOSDTime()`	获取当前播放时间戳
`int`	`getPlayPort()`
`int`	`getStreamFetchType()`	获取当前取流类型
`long`	`getStreamFlow()`	获取流量数据
`boolean`	`isSpeakerphoneOn()`	获取声音模式 false:耳机模式 true：听筒模式
`void`	`onCompletion(com.ez.player.EZMediaPlayer mp)`
`boolean`	`onError(com.ez.player.EZMediaPlayer mp, com.ez.player.EZMediaPlayer.MediaError error, int errorCode)`
`boolean`	`onInfo(com.ez.player.EZMediaPlayer mp, com.ez.player.EZMediaPlayer.MediaInfo info)`
`boolean`	`openSound()`	开启声音
`void`	`openVoiceTalkMicrophone()`	开启本地麦克风采集
`boolean`	`pausePlayback()`	暂停远程回放播放
`void`	`release()`
`boolean`	`resumePlayback()`	恢复远程回放播放
`boolean`	`seekPlayback(java.util.Calendar offsetTime)`	根据偏移时间播放拖动进度条时调用此接口。
`protected void`	`sendMessage(int msg, int arg1, java.lang.Object obj)`
`void`	`setAudioOnly(boolean audioOnly)`	设置RTMP音频播放，无视频
`boolean`	`setCloudPlaybackRate(EZConstants.EZCloudPlaybackRate rate)`	已过时。自4.8.8版本开始，请直接使用setPlaybackRate设置云存储回放速度，setCloudPlaybackRate接口不再维护，可能无法正常使用
`void`	`setDisplayRegion(boolean enable, CustomRect original, CustomRect current)`	已过时。建议换用setDisplayRegion(long left, long top, long right, long bottom)
`boolean`	`setDisplayRegion(long left, long top, long right, long bottom)`	设置电子放大区域 left, top, right, bottom均为-1时，表示关闭电子放大
`boolean`	`setHandler(android.os.Handler handler)`	设置Handler, 该handler将被用于从播放器向handler传递消息
`void`	`setHard(boolean enable)`	启用硬件加速功能,在start之前调用
`void`	`setHardDecode(boolean enable)`	设置硬解优先在调用startRealPlay或startPlayback前生效硬件解码功能生效后，EZPlayer.capturePicture方法失效（推荐上层用户使用TextureView的getBitmap方法进行抓图）
`void`	`setLeaveMessageFlowCallback(EZOpenSDKListener.EZLeaveMessageFlowCallback leaveMessageFlowCallback)`	设置留言下载回调
`void`	`setOriginDataCallback(EZOpenSDKListener.OriginDataCallback callback)`	（用于调试）设置原始码流数据回调在调用startRealPlay或startPlayback前生效
`boolean`	`setPlaybackRate(EZConstants.EZPlaybackRate rate)`	设置sdcard录像和云存储录像回放速度
`boolean`	`setPlaybackRate(EZConstants.EZPlaybackRate rate, int mode)`	设置sdcard录像和云存储录像回放速度
`void`	`setPlayVerifyCode(java.lang.String verifyCode)`	传入视频加密密码，用于加密视频的解码，该接口可以在收到ERROR_INNER_VERIFYCODE_NEED或ERROR_INNER_VERIFYCODE_ERROR错误回调时调用
`void`	`setSpeakerphoneOn(boolean on)`	切换模式 false:耳机模式 true：听筒模式
`void`	`setStreamDownloadCallback(EZOpenSDKListener.EZStreamDownloadCallback mStreamDownloadCallback)`	设置视频录制下载回调，适用于视频播放时的视频录制结果回调
`boolean`	`setSurfaceEx(android.graphics.SurfaceTexture surfaceTexture)`	设置播放器的显示Surface
`boolean`	`setSurfaceHold(android.view.SurfaceHolder surfaceHolder)`	设置播放器的显示Surface
`void`	`setVoiceTalkStatus(boolean pressed)`	半双工对讲时，设置对讲状态
`boolean`	`startLocalRecordWithFile(java.lang.String recordFile)`	开始本地直播流录像功能
`boolean`	`startLocalRecordWithFileEx(java.lang.String recordFile)`	开始本地直播流录像功能（保存为ps文件）需要保证以下权限： `Manifest.permission.WRITE_EXTERNAL_STORAGE`
`boolean`	`startPlayback(EZCloudRecordFile cloudFile)`	开始云存储远程回放
`boolean`	`startPlayback(EZDeviceRecordFile deviceFile)`	开始远程SD卡回放
`boolean`	`startPlayback(java.util.Calendar startTime, java.util.Calendar stopTime)`	开始远程SD卡回放---按时间回放
`void`	`startPlaybackV2(EZPlaybackStreamParam param)`
`boolean`	`startRealPlay()`	开始实时预览
`boolean`	`startVoiceTalk()`
`boolean`	`startVoiceTalk(boolean isDeviceTalkBack)`	开始对讲
`boolean`	`stopLocalRecord()`	结束本地直播流录像
`boolean`	`stopLocalRecordEx()`	结束本地直播流录像（保存为ps文件）需要保证以下权限： `Manifest.permission.WRITE_EXTERNAL_STORAGE`
`boolean`	`stopPlayback()`	停止远程回放
`boolean`	`stopRealPlay()`	结束实时预览
`boolean`	`stopVoiceTalk()`	停止对讲
`boolean`	`tryTransPsToMp4(java.lang.String psFilePath, java.lang.String mp4FilePath)`
`boolean`	`tryTransPsToMp4(java.lang.String psFilePath, java.lang.String mp4FilePath, java.lang.String verifyCode)`	转换ps文件为mp4文件

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - EZPlayer
```
public EZPlayer(EZStreamParamHelp paramHelp)
```
    摄像机预览、回放、对讲时使用此构造函数。可以通过EZOpenSDK.CreatePlayer创建播放对象
    
    参数:
    
    paramHelp -
  - EZPlayer
```
public EZPlayer(java.lang.String url)
```
    通过URL播放时使用此构造函数。可以通过EZOpenSDK.CreatePlayerWithUrl创建播放对象
  - EZPlayer
```
public EZPlayer()
```
  - EZPlayer
```
public EZPlayer(int userId,
                int cameraNo,
                int streamType)
```
- 方法详细资料
  - getPlayPort
```
public int getPlayPort()
```
  - release
```
public void release()
```
  - setSurfaceEx
```
public boolean setSurfaceEx(android.graphics.SurfaceTexture surfaceTexture)
```
    设置播放器的显示Surface
    
    参数:
    
    surfaceTexture - 用于播放的Surface
    
    返回:
    
    true 表示成功， false 表示失败
  - setSurfaceHold
```
public boolean setSurfaceHold(android.view.SurfaceHolder surfaceHolder)
```
    设置播放器的显示Surface
    
    参数:
    
    surfaceHolder - 用于播放的Surface
    
    返回:
    
    true 表示成功， false 表示失败
  - setAudioOnly
```
public void setAudioOnly(boolean audioOnly)
```
    设置RTMP音频播放，无视频
    
    参数:
    
    audioOnly -
  - setHandler
```
public boolean setHandler(android.os.Handler handler)
```
    设置Handler, 该handler将被用于从播放器向handler传递消息
    
    参数:
    
    handler - 处理消息的Handler
    
    返回:
    
    true 表示成功， false 表示失败
  - setPlayVerifyCode
```
public void setPlayVerifyCode(java.lang.String verifyCode)
```
    传入视频加密密码，用于加密视频的解码，该接口可以在收到ERROR_INNER_VERIFYCODE_NEED或ERROR_INNER_VERIFYCODE_ERROR错误回调时调用
    
    参数:
    
    verifyCode - 视频加密密码，默认为设备的6位验证码
  - startRealPlay
```
public boolean startRealPlay()
```
    开始实时预览
    
    返回:
    
    true 表示成功， false 表示失败
  - stopRealPlay
```
public boolean stopRealPlay()
```
    结束实时预览
    
    返回:
    
    true 表示成功， false 表示失败
  - capturePicture
```
public android.graphics.Bitmap capturePicture()
```
    开启截屏，需要先开启预览或回放
    
    返回:
    
    图片数据
  - capturePicture
```
public int capturePicture(java.lang.String fileNameWithPath)
```
    开启截屏，需要先开启预览或回放
    
    返回:
    
    成功返回EZ_OK,否则返回错误码
  - openSound
```
public boolean openSound()
```
    开启声音
    
    返回:
    
    true 表示成功， false 表示失败
  - closeSound
```
public boolean closeSound()
```
    关闭声音
    
    返回:
    
    true 表示成功， false 表示失败
  - getOSDTime
```
public java.util.Calendar getOSDTime()
```
    获取当前播放时间戳
    
    返回:
    
    true 表示成功， false 表示失败
  - startVoiceTalk
```
public boolean startVoiceTalk(boolean isDeviceTalkBack)
```
    开始对讲
    
    返回:
    
    true 表示成功， false 表示失败
  - startVoiceTalk
```
public boolean startVoiceTalk()
```
  - stopVoiceTalk
```
public boolean stopVoiceTalk()
```
    停止对讲
    
    返回:
    
    true 表示成功， false 表示失败
  - setVoiceTalkStatus
```
public void setVoiceTalkStatus(boolean pressed)
```
    半双工对讲时，设置对讲状态
    
    参数:
    
    pressed - ：true只说不停 false只听不说
  - openVoiceTalkMicrophone
```
public void openVoiceTalkMicrophone()
```
    开启本地麦克风采集
  - closeVoiceTalkMicrophone
```
public void closeVoiceTalkMicrophone()
```
    关闭本地麦克风采集
  - setStreamDownloadCallback
```
public void setStreamDownloadCallback(EZOpenSDKListener.EZStreamDownloadCallback mStreamDownloadCallback)
```
    设置视频录制下载回调，适用于视频播放时的视频录制结果回调
    
    参数:
    
    mStreamDownloadCallback -
  - startLocalRecordWithFile
```
public boolean startLocalRecordWithFile(java.lang.String recordFile)
```
    开始本地直播流录像功能
    
    返回:
    
    true 表示成功， false 表示失败
  - stopLocalRecord
```
public boolean stopLocalRecord()
```
    结束本地直播流录像
    
    返回:
    
    true 表示成功， false 表示失败
  - startPlayback
```
public boolean startPlayback(EZCloudRecordFile cloudFile)
```
    开始云存储远程回放
    
    参数:
    
    cloudFile - 云存储文件信息
    
    返回:
    
    true 表示成功， false 表示失败
  - startPlayback
```
public boolean startPlayback(EZDeviceRecordFile deviceFile)
```
    开始远程SD卡回放
    
    参数:
    
    deviceFile - SD卡文件信息
    
    返回:
    
    true 表示成功， false 表示失败
  - startPlayback
```
public boolean startPlayback(java.util.Calendar startTime,
                             java.util.Calendar stopTime)
```
    开始远程SD卡回放---按时间回放
    
    参数:
    
    startTime - 开始时间
    
    stopTime - 结束时间
    
    返回:
    
    true 表示成功， false 表示失败
  - stopPlayback
```
public boolean stopPlayback()
```
    停止远程回放
    
    返回:
    
    true 表示成功， false 表示失败
  - pausePlayback
```
public boolean pausePlayback()
```
    暂停远程回放播放
    
    返回:
    
    true 表示成功， false 表示失败
  - resumePlayback
```
public boolean resumePlayback()
```
    恢复远程回放播放
    
    返回:
    
    true 表示成功， false 表示失败
  - seekPlayback
```
public boolean seekPlayback(java.util.Calendar offsetTime)
```
    根据偏移时间播放拖动进度条时调用此接口。先停止当前播放，再把offsetTime作为起始时间按时间回放建议使用stopPlayback+startPlayback(offsetTime,stopTime代替此接口
    
    参数:
    
    offsetTime - 录像偏移时间
    
    返回:
    
    true 表示成功， false 表示失败
  - setDisplayRegion
```
public boolean setDisplayRegion(long left,
                                long top,
                                long right,
                                long bottom)
```
    设置电子放大区域 left, top, right, bottom均为-1时，表示关闭电子放大
    
    参数:
    
    left - x轴，左顶点坐标
    
    top - y轴，上顶点坐标
    
    right - x轴，右顶点坐标
    
    bottom - y轴，下顶点坐标
    
    返回:
    
    true-设置成功 false-设置失败
  - setDisplayRegion
```
public void setDisplayRegion(boolean enable,
                             CustomRect original,
                             CustomRect current)
                      throws PlaySDKException,
                             InnerException
```
    已过时。
    建议换用setDisplayRegion(long left, long top, long right, long bottom)
    
    电子放大，用于视频缩放
    
    参数:
    
    enable - 开启/关闭电子放大
    
    original - 缩放前的区域
    
    current - 需要缩放的区域
    
    抛出:
    
    PlaySDKException - 播放库异常
    
    InnerException - SDK内部异常
  - getLeaveMessageData
```
public void getLeaveMessageData(EZLeaveMessage msg,
                                EZOpenSDKListener.EZLeaveMessageFlowCallback leaveMessageFlowCallback)
```
    获取留言数据
    
    参数:
    
    msg - 留言信息
    
    leaveMessageFlowCallback - 流回调
  - setLeaveMessageFlowCallback
```
public void setLeaveMessageFlowCallback(EZOpenSDKListener.EZLeaveMessageFlowCallback leaveMessageFlowCallback)
```
    设置留言下载回调
    
    参数:
    
    leaveMessageFlowCallback - 回调
  - getStreamFlow
```
public long getStreamFlow()
```
    获取流量数据
    
    返回:
    
    返回获取流量数据
    
    从以下版本开始:
    
    V4.3
  - getStreamFetchType
```
public int getStreamFetchType()
```
    获取当前取流类型
    
    返回:
  - setPlaybackRate
```
public boolean setPlaybackRate(EZConstants.EZPlaybackRate rate)
```
    设置sdcard录像和云存储录像回放速度
    
    参数:
    
    rate - , EZ_PLAYBACK_RATE_1, // 1倍速 EZ_PLAYBACK_RATE_4, // 4倍速 EZ_PLAYBACK_RATE_4_1, // 1/4倍速 sdcard录像回放专用 EZ_PLAYBACK_RATE_8, // 8倍速 EZ_PLAYBACK_RATE_8_1, // 1/8倍速 sdcard录像回放专用 EZ_PLAYBACK_RATE_16, // 16倍速 EZ_PLAYBACK_RATE_16_1; // 1/16倍速 sdcard录像回放专用 EZ_PLAYBACK_RATE_32; // 32倍速云存储回放专用
    
    返回:
    
    成功返回true, 否则false并恢复成正常速度播放
    
    从以下版本开始:
    
    V1.8.2
  - setPlaybackRate
```
public boolean setPlaybackRate(EZConstants.EZPlaybackRate rate,
                               int mode)
```
    设置sdcard录像和云存储录像回放速度
    
    参数:
    
    rate - , EZ_PLAYBACK_RATE_1, // 1倍速 EZ_PLAYBACK_RATE_4, // 4倍速 EZ_PLAYBACK_RATE_4_1, // 1/4倍速 sdcard录像回放专用 EZ_PLAYBACK_RATE_8, // 8倍速 EZ_PLAYBACK_RATE_8_1, // 1/8倍速 sdcard录像回放专用 EZ_PLAYBACK_RATE_16, // 16倍速 EZ_PLAYBACK_RATE_16_1; // 1/16倍速 sdcard录像回放专用 EZ_PLAYBACK_RATE_32; // 32倍速云存储回放专用
    
    mode - 0代表4倍速及其以下全帧，以上则抽帧；1代表均使用抽帧；2代表均使用全帧，达不到要求则降速
    
    返回:
    
    成功返回true, 否则false并恢复成正常速度播放
    
    从以下版本开始:
    
    V1.8.2
  - setCloudPlaybackRate
```
public boolean setCloudPlaybackRate(EZConstants.EZCloudPlaybackRate rate)
```
    已过时。
    自4.8.8版本开始，请直接使用setPlaybackRate设置云存储回放速度，setCloudPlaybackRate接口不再维护，可能无法正常使用
    
    设置云存储录像回放速度
    
    参数:
    
    rate - , EZ_CLOUD_PLAYBACK_RATE_1(0), // 正常模式 EZ_CLOUD_PLAYBACK_RATE_4(1), // 4倍速 EZ_CLOUD_PLAYBACK_RATE_8(2), // 8倍速 EZ_CLOUD_PLAYBACK_RATE_16(3), // 16倍速 EZ_CLOUD_PLAYBACK_RATE_32(4); // 32倍速
    
    返回:
    
    成功返回true, 否则false并恢复成正常速度播放
    
    从以下版本开始:
    
    V1.8.2
  - onCompletion
```
public void onCompletion(com.ez.player.EZMediaPlayer mp)
```
    指定者:
    
    onCompletion 在接口中 com.ez.player.EZMediaPlayer.OnCompletionListener
  - onError
```
public boolean onError(com.ez.player.EZMediaPlayer mp,
                       com.ez.player.EZMediaPlayer.MediaError error,
                       int errorCode)
```
    指定者:
    
    onError 在接口中 com.ez.player.EZMediaPlayer.OnErrorListener
  - onInfo
```
public boolean onInfo(com.ez.player.EZMediaPlayer mp,
                      com.ez.player.EZMediaPlayer.MediaInfo info)
```
    指定者:
    
    onInfo 在接口中 com.ez.player.EZMediaPlayer.OnInfoListener
  - sendMessage
```
protected void sendMessage(int msg,
                           int arg1,
                           java.lang.Object obj)
```
  - setHard
```
public void setHard(boolean enable)
```
    启用硬件加速功能,在start之前调用
    
    参数:
    
    enable - true启用硬件加速,false关闭硬件加速
    
    从以下版本开始:
    
    V4.8.7
  - setSpeakerphoneOn
```
public void setSpeakerphoneOn(boolean on)
```
    切换模式 false:耳机模式 true：听筒模式
  - isSpeakerphoneOn
```
public boolean isSpeakerphoneOn()
```
    获取声音模式 false:耳机模式 true：听筒模式
  - setHardDecode
```
public void setHardDecode(boolean enable)
```
    设置硬解优先在调用startRealPlay或startPlayback前生效硬件解码功能生效后，EZPlayer.capturePicture方法失效（推荐上层用户使用TextureView的getBitmap方法进行抓图）
    
    参数:
    
    enable - true启用,false关闭
    
    从以下版本开始:
    
    V4.8.6.1
  - setOriginDataCallback
```
public void setOriginDataCallback(EZOpenSDKListener.OriginDataCallback callback)
```
    （用于调试）设置原始码流数据回调在调用startRealPlay或startPlayback前生效
    
    从以下版本开始:
    
    V4.8.7
  - startLocalRecordWithFileEx
```
public boolean startLocalRecordWithFileEx(java.lang.String recordFile)
```
    开始本地直播流录像功能（保存为ps文件）需要保证以下权限： Manifest.permission.WRITE_EXTERNAL_STORAGE
    
    返回:
    
    true 表示成功， false 表示失败
  - stopLocalRecordEx
```
public boolean stopLocalRecordEx()
```
    结束本地直播流录像（保存为ps文件）需要保证以下权限： Manifest.permission.WRITE_EXTERNAL_STORAGE
    
    返回:
    
    true 表示成功， false 表示失败
  - tryTransPsToMp4
```
public boolean tryTransPsToMp4(java.lang.String psFilePath,
                               java.lang.String mp4FilePath)
```
  - tryTransPsToMp4
```
public boolean tryTransPsToMp4(java.lang.String psFilePath,
                               java.lang.String mp4FilePath,
                               java.lang.String verifyCode)
```
    转换ps文件为mp4文件
    
    参数:
    
    psFilePath - 资源ps文件所在路径
    
    mp4FilePath - 目标mp4文件所在路径
    
    verifyCode - ps文件加密秘钥
    
    返回:
    
    转换结果 true-成功，false-失败
  - startPlaybackV2
```
public void startPlaybackV2(EZPlaybackStreamParam param)
```

类 EZPlayer

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

EZPlayer

EZPlayer

EZPlayer

EZPlayer

方法详细资料

getPlayPort

release

setSurfaceEx

setSurfaceHold

setAudioOnly

setHandler

setPlayVerifyCode

startRealPlay

stopRealPlay

capturePicture

capturePicture

openSound

closeSound

getOSDTime

startVoiceTalk

startVoiceTalk

stopVoiceTalk

setVoiceTalkStatus

openVoiceTalkMicrophone

closeVoiceTalkMicrophone

setStreamDownloadCallback

startLocalRecordWithFile

stopLocalRecord

startPlayback

startPlayback

startPlayback

stopPlayback

pausePlayback

resumePlayback

seekPlayback

setDisplayRegion

setDisplayRegion

getLeaveMessageData

setLeaveMessageFlowCallback

getStreamFlow

getStreamFetchType

setPlaybackRate

setPlaybackRate

setCloudPlaybackRate

onCompletion

onError

onInfo

sendMessage

setHard

setSpeakerphoneOn

isSpeakerphoneOn

setHardDecode

setOriginDataCallback

startLocalRecordWithFileEx

stopLocalRecordEx

tryTransPsToMp4

tryTransPsToMp4

startPlaybackV2