API 概览

public void init(Context context, Settings settings)
public void init(Context context, Settings settings, NemoSDKInitCallBack callBack) 
public void init(Context context, Settings settings, HttpsVerifier httpsVerifier, NemoSDKInitCallBack callBack)
   
public class Settings {
    /** 企业身份标识 */
    private String extID;
    /** 企业Token */
    private String extToken;
    /** 应用clientId (开始支持版本:v3.3.0) */ 
    private String clientId;
    /** 应用clientSecret (开始支持版本:v3.3.0)*/
    private String clientSecret;
    /** 私有云地址 */
    private String privateCloudAddress;
    /** 打印Log等级 */
    private LogLevel logLevel = LogLevel.LogLevel_Info;
    /** 0:后置 默认1:前置 */
    private int defaultCameraId = 1;
    /** SDK 日志文件路径 (开始支持版本:v3.3.2)*/
    private String logFilePath;
    /** SDK日志名称 (开始支持版本:v3.3.2)*/
    private String logFileName;
    /** SDK日志文件数量 (开始支持版本:v3.3.3)*/
    private int logFileNum = 10;
    /** 虚拟背景开关 (开始支持版本:v3.3.3)*/
    private boolean enableVirtualBg = true;
    /** 发言中开关 (开始支持版本:v2.29.6)*/
    private boolean uiNeedSpeakers;
    /**  */
    private boolean enableAudioPeakMeter;
    /** 人脸识别开关 (开始支持版本:v3.3.1)*/
    private boolean enableFaceRecognize;
    /** AudioDump调试开关  (开始支持版本:v3.3.2)*/
    private boolean enableAudioDump;
    /** VideoDump调试开关  (开始支持版本:v3.3.3)*/
    private boolean enableVideoDump;
    /** VideoDump调试开关  (开始支持版本:v3.3.4)*/
    private boolean enableAiCaption;
     /** 代理地址  (开始支持版本:v2.29.7)*/
    private String SocksProxyIp; 
    /** 代理端口  */
    private String SocksProxyPort; 
    /** 代理账户  */
    private String SocksProxyUserName; 
    /** 代理账户密码  */
    private String SocksProxyPassword; 

}

public void shutdown()

public String getSDKVersion()

//三方账户登录接口
public void loginExternalAccount(String displayName, String externalUserId, ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

//登录方法
public void loginExternalAccount(String displayName, String externalUserId, String extId, ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

//小鱼账号登录
public void loginXYlinkAccount(String username, String password, ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

//三方鉴权登录接口
public void loginExternalAccountByToken(String account, String token, ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

public void loginExtUserId(String displayName, String extUID, String authCode, final ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

public void loginXYAccount(String account, String password, String countryCode, final ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

public void loginExtToken(String token, final ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

public void loginXYLinkAccountByToken(String token, ConnectNemoCallback loginCallback)
//登录回调方法
public interface ConnectNemoCallback {

    /**
     * 连接小鱼服务失败
     * @param errorCode 错误码
     */
    void onFailed(String errorCode);

    /**
     * 连接小鱼服务成功
     * @param resp 登录成功的回调数据
     * @param isDetectingNetworkTopology 是否需要网络探测
     */

    void onSuccess(LoginResponseData resp, boolean isDetectingNetworkTopology);

    /**
     * 网络探测结束回调
     * @param resp 登录成功的回调数据
     */
    void onNetworkTopologyDetectionFinished(LoginResponseData resp);
}

public void logout()

public long getUserId()

public String getCallNumber()

public void reconnect()

//设置Ws链接状态回调callback
public void setOnStateChangeListener(OnStateChangeListener stateChangeListener)
//Ws链接状态回调方法
public interface OnStateChangeListener {
   /**
    * 连接状态回调
    */
   void onConnectStateChanged(boolean connected);

   /**
    * 重新认证回调(账号登录认证失效)
    */
   void unauthorized();
   
   /**
    * token过期 (开始支持版本:v3.3.0)
    */
   void onTokenExpired();
}

public void refreshToken(String refreshToken, RefreshTokenCallback callback) 
    
public interface RefreshTokenCallback {
    //刷新token成功回调
    void onRefreshTokenSuccess(TokenInfo tokenInfo);
    //刷新token失败回调
    void onRefreshTokenFail(String errorCode, String msg);
}

public void makeCall(String number, String password, MakeCallResponse response)
//呼叫回调方法
public interface MakeCallResponse {
   //呼叫成功回调，此时可以准备进入呼叫界面。
   void onCallSuccess();
   //呼叫失败回调。
   void onCallFail(String error, String msg);
}

public void makeCall(String number, String password, boolean micMute, boolean videoMute, MakeCallResponse response)
//呼叫回调方法
public interface MakeCallResponse {
   //呼叫成功回调，此时可以准备进入呼叫界面。
   void onCallSuccess();
   //呼叫失败回调。
   void onCallFail(String error, String msg);
}

public void makeCall(NemoCallConfig callConfig, MakeCallResponse response)
//呼叫回调方法
public interface MakeCallResponse {
   //呼叫成功回调，此时可以准备进入呼叫界面。
   void onCallSuccess();
   //呼叫失败回调。
   void onCallFail(String error, String msg);
}

//设置会中事件回调方法
public void setNemoSDKListener(NemoSDKListener nemoSDKListener)
//会议中回调方法
public interface NemoSDKListener {
    /**
     * 通话状态改变回调
     *
     * @param state  呼叫状态
     * @param reason 只有在state=DISCONNECTED时，有相应的原因。其他状态reason为null。
     * @param meetingId 只有在state=CONNECTED时，有会议ID。
     */
    void onCallStateChange(CallState state, String reason, String meetingId);

    /**
     * 通话视频信息改变回调
     *
     * @param videoInfos 当前通话视频信息
     * @param hasVideoContent 是否有参会者正在内容分享
     */
    void onVideoDataSourceChange(List<VideoInfo> videoInfos, boolean hasVideoContent);

    /**
     * 与会者信息变化回调
     *
     * @param roster 参会者信息
     */
    void onRosterChange(RosterWrapper roster);

     /**
     * 会控消息改变通知
     * @param confMgmtState 会控信息
     */
    void onConfMgmtStateChanged(ConfMgmtState confMgmtState);
    
    /**
     * 录制消息变化回调
     *
     * @param recordState 录制信息封装对象
     */
    void onRecordStatusNotification(ConfRecordState recordState);

    /**
     * 用户被踢下线回调，可能同一账号在其他端登录
     *
     * @param code   错误码
     * @param reason 参考附录
     */
    void onKickOut(int code, int reason);

    /**
     * 本地网络质量提示
     *
     * @param level 1、2、3、4个等级,差-中-良-优
     */
    void onNetworkIndicatorLevel(int level);

    /**
     * 视频状态提示
     *
     * @param videoStatus 0：正常 1：本地网络不稳定 2：系统忙，视频质量降低 3：对方网络不稳定 4：网络不稳定，请稍候 5：WiFi信号不稳定
     */
    void onVideoStatusChange(int videoStatus);

    /**
     * 呼叫中提示
     *
     * @param callIndex
     * @param type      呼叫类型
     * @param values    呼叫人数
     */
    void onIMNotification(int callIndex, String type, String values);

    /**
     * 来电的回调
     *
     * @param name   名称
     * @param number 号码
     */
    void onCallReceive(String name, String number, int callIndex);

    /**
     * @param state  状态
     * @param reason
     * @param type
     */
    void onDualStreamStateChange(NemoDualState state, String reason, int type);

    /**
     * 人脸信息回调
     *
     * @param aiParam     人脸信息
     * @param isLocalFace 是否为本地人脸信息, true:为本地人脸, false: 远端人脸信息
     */
    void onAiFace(AIParam aiParam, boolean isLocalFace);

    /**
     * 通话字幕回调
     
     * @param aiCaptionInfo
     */
    void onAiCaption(AICaptionInfo aiCaptionInfo);

    /**
     * 通话中收到来电
     *
     * @param callIndex
     * @param callNumber
     */
    void onCallInvite(CallState state, int callIndex, String callNumber, String callName);

     /**
     * 会议中弹幕
     *
     * @param content  消息内容
     * @param location 消息显示位置，top上方显示，middle中间显示，bottom底部显示
     * @param action   操作消息动作，push推送消息，cancel取消显示消息
     * @param scroll   消息是否滚动，0 不滚动，1 滚动
     * @param fontSize 字幕文字大小，small、middle、big
     * @param fontRGB  字幕文字颜色  rgb
     * @param scrollSpeed 字幕滚动速度，low、middle、high
     * @param backgroundAlpha 字幕背景透明度 0 - 1
     * @param backgroundRGB 字幕背景颜色 rgb
     */
    void onCaptionNotification(String content, String location, String action, String scroll, String fontSize, String fontRGB, String scrollSpeed, String backgroundAlpha, String backgroundRGB);


    /**
     * Active Speaker 变化
     * @param speakers 发言者列表 (开始支持版本:v2.29.7)
     */
    void onSpeakerChanged(List<Speaker> speakers);

     /**
     * 回声检测 (开始支持版本:v2.29.7)
     */
    void onHowlingDetected(boolean detected);

     /**
     * 出入会通知 (开始支持版本:v2.29.7)
     */
    void onInOutReminder(List<InOutMeetingInfo> inOutList);
    
     /**
     * 会议是否锁定邀请 (开始支持版本:v3.3.1)
     */
    void onMeetingLocked(String meetingId, boolean locked);
    
     /**
     * 会议主持状态 (开始支持版本:v3.3.1)
     */
    void onMeetingHostChanged(String meetingId, boolean host);
    
    /**
     * 会控关闭音视频 (开始支持版本:v3.3.2)
     */
    void onMeetingMuteQuery(String meetingId, String key);
    
    /**
     * 会议主持人 (开始支持版本:v3.3.4)
     */
    void onMeetingOwnerChanged(String meetingId, boolean owner);
    /**
     * 清除举手状态 (开始支持版本:v3.3.4)
     */
    void onMeetingForceHandDown();
    /**
     * 全量roster变更
     */
    void onBulkRosterChange(BulkRosterWrapper rosterWrapper);
}

public void setNemoReceivedCallListener(@NonNull NemoReceivedCallListener nemoReceivedCallListener)
//被呼叫回调方法
public interface NemoReceivedCallListener {
    /**
     * 接收呼叫回调
     * @param name 呼叫者的名称
     * @param number 呼叫者号码
     * @param callIndex 呼叫的index，回应此呼叫时需要使用
     */
    void onReceivedCall(String name, String number, int callIndex);
}

public void switchCallMode(boolean audioMode)

public void answerCall(int callIndex, boolean accept)

public void hangup()

public void hangup(boolean endRecord)

public boolean inCalling()

public static String getLocalVideoStreamID()

public void forceLayout(int participantId)

public boolean isCustomLayoutEnabled()

public void setLayoutBuilder(LayoutBuilder layoutBuilder)
//请流合集计算
public interface LayoutBuilder {
        /**
         * 计算布局元素
         * @param policy layoutPolicy
         * @return 请流集合
         */
        List<LayoutElement> compute(LayoutPolicy policy);
    }

public void releaseLayout()

public String getDataSourceId()

public void subscribeRoster(List<String> uris)

public void requestRoster(int startIndex, int length)

public void switchCamera(int cameraId)

public void setVideoMute(boolean isMuteVideo)

public void setOrientation(@Orientation int orientation)
//屏幕方向定义
public @interface Orientation {
    int PORTRAIT = 0;            // 竖屏    0度：手机默认竖屏状态（home键在正下方）
    int LANDSCAPE = 3;           // 横屏    90度：手机顺时针旋转90度横屏（home建在左侧）
    int REVERSE_LANDSCAPE = 2;   // 反向横屏 270度：手机顺时针旋转270度横屏，（home键在右侧）
}

public void switchSpeakerOnModle(boolean speakerModle)

public void switchSpeakerDevice(@SpeakerDevice int speakerDevice)

public void enableMic(boolean isMuteMic, boolean notifyRemote)

public void enableMic(boolean isMuteMic, boolean notifyRemote, String reason)

public void setSpeakerMute(boolean mute)

public boolean isMicMuted()

public void setAudioMute(boolean mute)

public void farEndHardwareControl(int participantId, FECCCommand command, int angle)
//Fecc指令定义
public enum FECCCommand implements Parcelable {
    FECC_TURN_LEFT,
    FECC_STEP_LEFT,
    FECC_TURN_RIGHT,
    FECC_STEP_RIGHT,
    FECC_TURN_STOP,
    TILT_CAMERA_TURN_UP,
    TILT_CAMERA_STEP_UP,
    TILT_CAMERA_TURN_DOWN,
    TILT_CAMERA_STEP_DOWN,
    TILT_CAMERA_TURN_STOP,
    FECC_ZOOM_IN,
    FECC_ZOOM_OUT,
    FECC_STEP_ZOOM_IN,
    FECC_STEP_ZOOM_OUT,
    FECC_ZOOM_TURN_STOP,
    FECC_UNKNOWN;

public ArrayList<AudioMeter> getAudioPeakMeters()

public void setSpeakerOnModeDefault(boolean speakerOnModeDefault)

public boolean isSpeakerOnModeDefault()

public void setDefaultSpeakerDevice(int speakerDevice)

public int defaultSpeakerDevice()

public static int defaultCameraId()

public void setDefaultCameraId(int cameraId)

public void requestCamera()

public void releaseCamera()

public void requestAudioMic()

public void releaseAudioMic()

public void setMicAudioDataListener(AudioDataListener micAudioDataListener)

public void setMicDataByAEReadyEnabled(boolean enabled)

public void setAEAudioDataListener(AudioDataListener audioDataListener)
//音频旁路回调
public interface AudioDataListener {
    /**
     * @param data 音频字节数组
     * @param length 字节数组长度
     * @param formatType 压缩格式
     * @param samplesPerSec 采样率
     * @param numChannels  通道数
     * @param bitsPerSample 每个采样点的bit数
     */
    void onMicDataReady(byte[] data, int length, int formatType, int samplesPerSec, int numChannels, int bitsPerSample);
}

public void setVideoConfiguration(@VideoConfig String videoMaxResolutionTx)
//支持分辨率枚举
public @interface VideoConfig {
    String VD_640x360 = "640_360";
    String VD_1280x720 = "1280_720";
}

public void sendDtmf(String uri, String key)

public Observable<List<SitePath>> getSitePaths()

Observable<Integer> configSitePath(String sitePathId)

public Observable<Integer> deleteSitePath()

public void setNetworkTestListener(NNTJniListener.OnNetworkDiagnoseListener listener)

public void startNetworkTest()

public void stopNetworkTest()

public void validateSocksProxy(String ip, int port, String userName, String password, SocketProxyCallback socketProxyCallback)

public void setSocksProxy(String ip, int port, String userName, String password)

public byte[] getVideoDataBySourceId(String dataSourceId)

public boolean isSupportVirtualBg()

/**
     * 设置视频虚拟背景
     *
     * @param bgMode    虚拟背景模式
     * @param imgPath   虚拟背景图片路径
     * @param imgWidth  虚拟背景图片宽度
     * @param imgHeight 虚拟背景图片高度
     */
public void setVirtualBgMode(int bgMode, String imgPath, int imgWidth, int imgHeight)

public int getCurrentCameraId()

/**
  * @param flip 是否镜像
  */
public int setLocalVideoFlip(boolean flip)

public boolean isLocalVideoFlipping()

/**
  * 设置美颜滤镜
  * @param effectType   特效类型, 参考{@link BeautyType 美颜类型}、{@link FilterType 滤镜类型}定义
  * @param filterLevel  特效等级, 0-100
  */
public void setVideoEffect(String effectType, int filterLevel)

/**
  * @param callback 设备状态回调
  */
public void setMediaEventCallback(MediaEventCallback callback)
  
public interface MediaEventCallback {
   //摄像机异常回调
    void onCameraError(String errorCode);
}  

public boolean isSupportAiCaption()

public void setSubtitleLanguage(@SubtitleLanguage String language)

public String getMeetingHost()

public void handUp()

public void handDown()

public void endSpeech()

public void signIn(SignStartResponse response)

public void setInteractiveEventCallback(InteractiveEventCallback callback)
    
public interface InteractiveEventCallback {
    //签到开始
    void onSignInStart(VoteStartResponse response);
    //签到结束
    void onSignInStop(VoteStopResponse response);
    //签到结果
    void onSignInResult(SignResultResponse signResponse);
    //答题开始
    void onAnswerStart(VoteStartResponse response);
    //答题结束
    void onAnswerStop(VoteStopResponse response);
    //展示答题结果
    void onPublishAnswerStart(PublishStartResponse response);
    //结束展示答题结果
    void onPublishAnswerStop(PublishStopResponse response);
}

public void startRecord(String meetingNumber, RecordCallback callback)
public interface RecordCallback {
    /**
     * 录制启动失败
     * @param errorCode 错误码
     */
    void onFailed(int errorCode);

    /**
     * 录制启动成功
     */
    void onSuccess();
}

public void stopRecord()

public void startWhiteboard()

public void stopWhiteboard()

public void registerWhiteboardChangeListener(WhiteboardChangeListener listener)
//白板服务回调
public interface WhiteboardChangeListener {
    /**
     * 白板打开。
     */
    void onWhiteboardStart();

    /**
     * 白板关闭。
     */
    void onWhiteboardStop();

    /**
     * 收到白板消息。
     * @param message 白板消息
     */
    void onWhiteboardMessage(String message);

    /**
     * 白板内容消息集合
     * @param messages 白板消息集合
     */
    void onWhiteboardMessages(ArrayList<String> messages);

    /**
     * 批注准备就绪
     */
    void onAnnotationSending();
}

public void sendWhiteboardData(String data)

public void startAnnotation()

public void stopAnnotation()

public void sendAnnotationMessage(String data)

public void dualStreamStart(@ContentType int type, boolean allowAnnotation)

public @interface ContentType {
    int CONTENT_TYPE_PICTURE = 3; //分享图片
    int CONTENT_TYPE_SCREEN = 0; //分享屏幕
    int CONTENT_TYPE_SCREEN_WITH_AUDIO = 1; //分享屏幕&声音 (v3.3.3版本已移除)
}

public void dualStreamStop(@ContentType int type)

public @interface ContentType {
    int CONTENT_TYPE_PICTURE = 3; //分享图片
    int CONTENT_TYPE_SCREEN = 0; //分享屏幕
}

 public void startCaptureContentAudio(MediaProjection mediaProjection)

public void stopCaptureContentAudio()

public void enableFaceRecognize(boolean enable)

public void enableElectronicBadge(boolean enable)

public void enabledFaceDetectType(@FaceDetectType int type, boolean enable)

public Observable<FaceInfo> getFaceInfo(long faceId)

public Observable<List<FaceInfo>> getMultiFaceInfo(long[] faceIds)

public NewStatisticsInfo getStatisticsInfo()

public void sendFeedbackLog(String comment)

public static String signUrl(String method, String url, String body, String extId, String token)

public void setSaveNetMode(boolean isSaveNetMode)