- Package
- Class
- Tree
- Deprecated
- Index
- Help
- Detail:
- Field |
- Constr |
- Method
cn.jiguang.jmrtc.api
Class JMRtcClient
- java.lang.Object
- cn.jiguang.jmrtc.api.JMRtcClient
public class JMRtcClient extends java.lang.Object
JMRTC接口类
Nested Class Summary
Nested Classes Modifier and Type Class and Description static class
JMRtcClient.DisconnectReason
static class
JMRtcClient.VideoProfile
Method Summary
All Methods Static Methods;) Instance Methods;) Concrete Methods;) Modifier and Type Method and Description void
accept(BasicCallback callback)
接受通话邀请。 此接口只能在收到通话邀请、sdk回调了JMRtcListener.onCallInviteReceived(JMRtcSession)
之后,才能发起调用。
void
call(java.util.List
发起通话邀请。 任何通话的发起都应该以此接口开始。
boolean
enableAudio(boolean isEnable)
设置本地音频输出开关。只在视频或语音通话连接建立之后调用有效。
boolean
enableSpeakerphone(boolean isEnable)
设置使用本地外置扬声器开关。只在视频或语音通话连接建立之后调用有效。
boolean
enableVideo(boolean isEnable)
设置本地视频输出开关。只在视频通话连接建立之后调用有效。
static JMRtcClient
getInstance()
JMRtcSession
getSession()
获取当前通话session对象。
JMRtcClient.VideoProfile
getVideoProfile()
获取当前设置的视频编码属性
void
hangup(BasicCallback callback)
通话挂断。 此接口可以在邀请阶段以及通话阶段由任意通话中用户发起
void
initEngine(JMRtcListener listener)
初始化音视频引擎。 在使用其他接口之前,必须先调用此接口初始化引擎。
void
invite(java.util.List
向其他用户发起邀请,加入通话。 此接口只能在通话建立、sdk回调了JMRtcListener.onCallConnected(JMRtcSession, SurfaceView)
接口之后,才能发起调用。
void
onEvent(JMRtcNotificationEvent notificationEvent)
void
onEvent(LoginStateChangeEvent loginStateChangeEvent)
void
refuse(BasicCallback callback)
拒绝通话邀请。 此接口只能在收到通话邀请、sdk回调了JMRtcListener.onCallInviteReceived(JMRtcSession)
之后,才能发起调用。
void
reinitEngine()
重新初始化音视频引擎。 当引擎因为权限或者其他原因初始化失败,状态停留在uninit时,可以通过此接口尝试重新初始化引擎。
void
releaseEngine()
释放音视频引擎。 释放之后如果需要再次使用音视频服务,需要重新调用initEngine(JMRtcListener)
来重新初始化音视频引擎。
void
setVideoProfile(JMRtcClient.VideoProfile videoProfile)
设置视频输出的编码属性
boolean
switchCamera()
切换前置/后置摄像头。只在视频或语音通话连接建立之后调用有效。
-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Method Detail
-
getInstance
public static JMRtcClient getInstance()
-
initEngine
public void initEngine(JMRtcListener listener)
初始化音视频引擎。 在使用其他接口之前,必须先调用此接口初始化引擎。
调用此接口,sdk背后会检查初始化所需要的权限。如果必要权限没有获取到,则会触发JMRtcListener.onPermissionNotGranted(String[])
回调通知上层。
- Parameters:
- <code>listener</code> - 音视频相关事件回调监听类
-
reinitEngine
public void reinitEngine()
重新初始化音视频引擎。 当引擎因为权限或者其他原因初始化失败,状态停留在uninit时,可以通过此接口尝试重新初始化引擎。
-
releaseEngine
public void releaseEngine()
释放音视频引擎。 释放之后如果需要再次使用音视频服务,需要重新调用initEngine(JMRtcListener)
来重新初始化音视频引擎。
-
enableVideo
public boolean enableVideo(boolean isEnable)
设置本地视频输出开关。只在视频通话连接建立之后调用有效。 视频通话中默认打开。音频通话中此接口无效。
- Parameters:
- <code>isEnable</code> - true - 开启视频输出, false - 关闭视频输出
- Returns:
- 操作结果。 true - 操作成功,false - 操作失败
-
enableAudio
public boolean enableAudio(boolean isEnable)
设置本地音频输出开关。只在视频或语音通话连接建立之后调用有效。 默认打开。
- Parameters:
- <code>isEnable</code> - true - 开启音频输出, false - 关闭音频输出
- Returns:
- 操作结果。 true - 操作成功,false - 操作失败
-
enableSpeakerphone
public boolean enableSpeakerphone(boolean isEnable)
设置使用本地外置扬声器开关。只在视频或语音通话连接建立之后调用有效。 默认打开
- Parameters:
- <code>isEnable</code> - true - 使用外置扬声器, false - 不使用外置扬声器
- Returns:
- 操作结果。 true - 操作成功,false - 操作失败
-
switchCamera
public boolean switchCamera()
切换前置/后置摄像头。只在视频或语音通话连接建立之后调用有效。 默认使用前置摄像头
- Returns:
- 操作结果。 true - 操作成功,false - 操作失败
-
setVideoProfile
public void setVideoProfile(JMRtcClient.VideoProfile videoProfile)
设置视频输出的编码属性 视频通话期间调用此接口设置的属性将在下次视频通话中生效
- Parameters:
- <code>videoProfile</code> - 视频编码属性
-
getVideoProfile
public JMRtcClient.VideoProfile getVideoProfile()
获取当前设置的视频编码属性
默认为JMRtcClient.VideoProfile.Profile_360P
- Returns:
-
getSession
public JMRtcSession getSession()
获取当前通话session对象。
- Returns:
- [<code>JMRtcSession</code>](../../../../cn/jiguang/jmrtc/api/JMRtcSession.html)对象,如果当前不在任何会话中,则返回null。
-
call
public void call(java.util.List<UserInfo> invitedUsers, JMSignalingMessage.MediaType mediaType, BasicCallback callback)
发起通话邀请。 任何通话的发起都应该以此接口开始。
邀请发出之后,触发JMRtcListener.onCallOutgoing(JMRtcSession)
回调,通知上层正在发起通话。之后进入outgoing状态。
被邀请方收到邀请时,触发JMRtcListener.onCallInviteReceived(JMRtcSession)
回调,通知上层收到邀请。
- Parameters:
- <code>invitedUsers</code> - 被邀请的用户的UserInfo集合
- <code>mediaType</code> - 通话类型
- <code>callback</code> - 结果回调
-
invite
public void invite(java.util.List<UserInfo> invitedUsers, BasicCallback callback)
向其他用户发起邀请,加入通话。 此接口只能在通话建立、sdk回调了JMRtcListener.onCallConnected(JMRtcSession, SurfaceView)
接口之后,才能发起调用。
邀请发出之后,当前通话中的其他用户会触发JMRtcListener.onCallOtherUserInvited(UserInfo, List, JMRtcSession)
回调,通知上层有其他人被邀请加入通话
被邀请方收到邀请时,触发JMRtcListener.onCallInviteReceived(JMRtcSession)
回调,通知上层收到邀请。
- Parameters:
- <code>invitedUsers</code> - 被邀请的用户的UserInfo集合
- <code>callback</code> - 结果回调
-
accept
public void accept(BasicCallback callback)
接受通话邀请。 此接口只能在收到通话邀请、sdk回调了JMRtcListener.onCallInviteReceived(JMRtcSession)
之后,才能发起调用。
成功调用后,双方都会触发JMRtcListener.onCallConnected(JMRtcSession, SurfaceView)
通知上层通话连接已建立。 并且sdk会通过JMRtcListener.onCallMemberJoin(UserInfo, SurfaceView)
上报当前已经在通话频道内的用户。
- Parameters:
- <code>callback</code> - 结果回调
-
refuse
public void refuse(BasicCallback callback)
拒绝通话邀请。 此接口只能在收到通话邀请、sdk回调了JMRtcListener.onCallInviteReceived(JMRtcSession)
之后,才能发起调用。
成功调用后,被邀请方会触发JMRtcListener#onCallDisconnected(DisconnectReason)
通知上层连接断开,通话已结束。
邀请方触发JMRtcListener#onCallMemberOffline(UserInfo, DisconnectReason)
通知上层有用户离线,离线原因refuse(BasicCallback)
- Parameters:
- <code>callback</code> - 结果回调
-
hangup
public void hangup(BasicCallback callback)
通话挂断。 此接口可以在邀请阶段以及通话阶段由任意通话中用户发起
成功调用后,调用者会触发JMRtcListener#onCallDisconnected(DisconnectReason)
通知上层连接断开,通话已结束。
其他用户触发JMRtcListener#onCallMemberOffline(UserInfo, DisconnectReason)
通知上层有用户离线,离线原因hangup(BasicCallback)
- Parameters:
- <code>callback</code> - 结果回调
-
onEvent
public void onEvent(JMRtcNotificationEvent notificationEvent)
-
onEvent
public void onEvent(LoginStateChangeEvent loginStateChangeEvent)
- Package
- Class
- Tree
- Deprecated
- Index
- Help
- Detail:
- Field |
- Constr |
- Method