快速开始

/**
 * SDK 相关信息存放目录，包括账号信息，日志信息等，默认为 sdcard/Android/data/包名/files 下
 */
public String sdkInfoDir;
/**
 * SDK 日志目录，如果不设置则默认在 sSdkInfoDir 下的 log 目录中
 */
public String sdkLogDir;
/**
 * 是否内部自动加载so库，默认为 true，如果上层需要自己加载则设置为 false
 */
public boolean needLoadLibrary = true;
/**
 * sdk 日志等级
 */
public @LogLevel int sdkLogLevel;

/**
 * disable日志等级
 */
public static final int LOG_LEVEL_DISABLE = 0;
/**
 * error日志等级
 */
public static final int LOG_LEVEL_ERROR = 1;
/**
 * info日志等级
 */
public static final int LOG_LEVEL_INFO = 2;
/**
 * debug日志等级
 */
public static final int LOG_LEVEL_DEBUG = 3;

/**
 * 创建 JCClient 实例
 *
 * @param context   上下文句柄
 * @param appKey    用户从 Juphoon Cloud 平台上申请的 AppKey 字符串
 * @param callback    回调接口，用于接收 JCClient 相关通知
 * @param createParam 创建参数，null 则按默认值创建
 * @return JCClient 对象
 */
public static JCClient create(@NonNull Context context, @NonNull String appKey, @NonNull JCClientCallback callback, CreateParam createParam) {

public boolean initialize(Context context) {
    // 初始化各模块，因为这些模块实例将被频繁使用，建议声明在单例中
    JCClient.CreateParam createParam = new JCClient.CreateParam(this);
    createParam.sdkLogLevel = LOG_LEVEL_INFO;
    createParam.sdkInfoDir = "SDK 信息存放路径";
    createParam.sdkLogDir = "日志存放路径";
    JCClient client = JCClient.create(Context, "your appkey", this, createParam);
    return true;
}

/**
 * 创建参数
 * @return 创建参数
 */
public abstract CreateParam getCreateParam();

JCClient.CreateParam createParam = client.getCreateParam();
			

JCClient.LoginParam loginParam = new JCClient.LoginParam();
//默认国内环境 http:cn.router.justalkcloud.com:8080
loginParam.serverAddress = "服务器地址";
//如果使用代理服务器登录
loginParam.httpsProxy = "代理服务器地址";

/**
 * 设置昵称，用于通话，消息等，可以更直观的表明身份
 * @param displayName 昵称
 */
public abstract void setDisplayName(@NonNull String displayName);

client.setDisplayName("小张");
			

/**
 * 登陆 Juphoon Cloud 平台，只有登陆成功后才能进行平台上的各种业务<br>
 * 登陆结果通过 JCCallCallback 通知<br>
 * 注意:用户名为英文数字和'+' '-' '_' '.'，长度不要超过64字符，'-' '.' '_'字符不能处于第一位<br>
 *
 * @param userId   用户名
 * @param password 密码，但不能为空
 * @param loginParam 登录参数，null 则按默认值
 * @return 返回 true 表示正常执行调用流程，false 表示调用异常，异常错误通过 JCClientCallback 通知
 */
public abstract boolean login(@NonNull String userId, @NonNull String password, LoginParam loginParam);

/**
 * 登录服务器地址
 */
public String serverAddress = "http:cn.router.justalkcloud.com:8080";
/**
 * https代理地址，例如 192.168.1.100:3128
 */
public String httpsProxy;
/**
 * 设备id，一般模拟器使用，因为模拟器可能获得的设备id都一样
 */
public String deviceId;
/**
 * 登录账号不存在的情况下是否内部自动创建该账号，默认为 true
 */
public boolean autoCreateAccount = true;

JCClient.LoginParam loginParam = new JCClient.LoginParam();
//默认国内环境 http:cn.router.justalkcloud.com:8080
loginParam.serverAddress = "http:cn.router.justalkcloud.com:8080";
client.login("账号", "123", loginParam);

/**
 * 登录状态变化通知
 *
 * @param state    当前状态值
 * @param oldState 之前状态值
 */
void onClientStateChange(@JCClient.ClientState int state, @JCClient.ClientState int oldState);

// 未初始化
public static final int STATE_NOT_INIT = 0;
// 未登录
public static final int STATE_IDLE = 1;
// 登录中
public static final int STATE_LOGINING = 2;
// 登录成功
public static final int STATE_LOGINED = 3;
// 登出中
public static final int STATE_LOGOUTING = 4;

public void onClientStateChange(@JCClient.ClientState int state, @JCClient.ClientState int oldState) {
     if (state == JCClient.STATE_IDLE) { // 未登录
       ...
    } else if (state == JCClient.STATE_LOGINING) { // 正在登录
       ...
    } else if (state == JCClient.STATE_LOGINED) { // 登录成功
       ...
    } else if (state == JCClient.STATE_LOGOUTING) { // 登出中
       ...
    }
}

/**
 * 登陆结果回调
 *
 * @param result true 表示登陆成功，false 表示登陆失败
 * @param reason 当 result 为 false 时该值有效
 */
void onLogin(boolean result, @JCClient.ClientReason int reason);

/**
 * 正常
 */
public static final int REASON_NONE = 0;
/**
 * sdk 未初始化
 */
public static final int REASON_SDK_NOT_INIT = 1;
/**
 * 无效参数
 */
public static final int REASON_INVALID_PARAM = 2;
/**
 * 函数调用失败
 */
public static final int REASON_CALL_FUNCTION_ERROR = 3;
/**
 * 当前状态无法再次登录
 */
public static final int REASON_STATE_CANNOT_LOGIN = 4;
/**
 * 超时
 */
public static final int REASON_TIMEOUT = 5;
/**
 * 网络异常
 */
public static final int REASON_NETWORK = 6;
/**
 * appkey 错误
 */
public static final int REASON_APPKEY = 7;
/**
 * 账号密码错误
 */
public static final int REASON_AUTH = 8;
/**
 * 无该用户
 */
public static final int REASON_NOUSER = 9;
/**
 * 强制登出
 */
public static final int REASON_SERVER_LOGOUT = 10;
/**
 * 其他错误
 */
public static final int REASON_OTHER = 100;

/**
 * 登出 Juphoon Cloud 平台，登出后不能进行平台上的各种业务
 *
 * @return 返回 true 表示正常执行调用流程，false 表示调用异常，异常错误通过 JCClientCallback 通知
 */
public abstract boolean logout();

/**
 * 登出回调
 *
 * @param reason 登出原因
 */
void onLogout(@JCClient.ClientReason int reason);

/**
 * 设置是否为前台, 在有控制后台网络的手机上当进入前台时主动触发
 *
 * @param foreground 是否为前台
 */
public abstract void setForeground(boolean foreground);

/**
 * 创建 JCMediaDevice 对象
 *
 * @param client   JCClient 对象
 * @param callback JCMediaDeviceCallback 回调接口，用于接收 JCMediaDevice 相关通知
 * @return 返回 JCMediaDevice 对象
 */
public static JCMediaDevice create(JCClient client, JCMediaDeviceCallback callback);

/**
 * 创建JCCall实例
 *
 * @param client        JCClient实例
 * @param mediaDevice   JCMediaDevice实例
 * @param callback      回调接口，用于接收 JCCall 相关回调事件
 * @return JCCall       JCCall实例
 */
public static JCCall create(JCClient client, JCMediaDevice mediaDevice, JCCallCallback callback);

// 初始化各模块，因为这些模块实例将被频繁使用，建议声明在单例中
JCMediaDevice mediaDevice = JCMediaDevice.create(client, this);
JCCall call = JCCall.create(client, mediaDevice, this);

/**
 * 一对一呼叫
 *
 * @param userId        用户标识
 * @param video         是否视频呼叫
 * @param extraParam    透传参数，设置后被叫方可获取该参数
 * @return              返回 true 表示正常执行调用流程，false 表示调用异常
 */
public abstract boolean call(String userId, boolean video, String extraParam);

/**
 * 新增通话回调
 *
 * @param item JCCallItem 对象
 */
void onCallItemAdd(JCCallItem item);

public void onCallItemAdd(JCCallItem item) {
    // 新增通话回调
}

/**
 * 获得视频预览对象，通过此对象能获得视频用于UI显示
 *
 * @param renderType    渲染模式
 * @return              JCMediaDeviceVideoCanvas 对象
 * @see RenderType
 */
public abstract JCMediaDeviceVideoCanvas startCameraVideo(@RenderType int renderType);

/**
 * 铺满窗口
 */
public static final int RENDER_FULL_SCREEN = 0;
/**
 * 全图像显示，会有黑边，类似放电影的荧幕
 */
public static final int RENDER_FULL_CONTENT = 1;
/**
 * 自适应
 */
public static final int RENDER_FULL_AUTO = 2;

// 发起视频呼叫
call.call("peer number", true, "自定义透传字符串");
// 打开本地视频预览
JCMediaDeviceVideoCanvas localCanvas = mediaDevice.startCameraVideo(JCMediaDevice.RENDER_FULL_CONTENT);
viewGroup.addView(localCanvas.getVideoView(), 0);

/**
 * 接听
 *
 * @param item  JCCallItem 对象
 * @param video 针对视频呼入可以选择以视频接听还是音频接听
 * @return 返回 true 表示正常执行调用流程，false 表示调用异常
 */
public abstract boolean answer(JCCallItem item, boolean video);

public void onCallItemAdd(JCCallItem item) {
    // 如果是视频呼入且在振铃中
    if (item.getDirection() == JCCall.DIRECTION_IN && item.getVideo()) {
        // 应答通话
        call.answer(item, true);
    }
}

/**
 * 获得视频对象，通过此对象能获得视频用于UI显示
 *
 * @param videoSource   渲染标识串，比如 JCMediaChannelParticipant JCCallItem 中的 renderId
 * @param renderType    渲染模式
 * @return              JCMediaDeviceVideoCanvas 对象
 * @see RenderType
 */
public abstract JCMediaDeviceVideoCanvas startVideo(String videoSource, @RenderType int renderType);

public void onCallItemUpdate(JCCallItem item) {
    // 如果对端在上传视频流（uploadVideoStreamOther）
    if (item.getState() == JCCall.STATE_TALKING && remoteCanvas == null && item.getUploadVideoStreamOther()) {
        // 获取远端视频画面，renderId来源JCCallItem对象
        JCMediaDeviceVideoCanvas remoteCanvas = mediaDevice.startVideo(item.renderId, JCMediaDevice.RENDER_FULL_CONTENT);
        viewGroup.addView(remoteCanvas.getVideoView(), 0);
    }
}

/**
 * 获得当前活跃的通话
 *
 * @return 有返回 JCCallItem 对象，没有返回 null
 */
public abstract JCCallItem getActiveCallItem();

/**
 * 挂断
 *
 * @param item          JCCallItem 对象
 * @param reason        挂断原因
 * @param description   挂断描述
 * @return              返回 true 表示正常执行调用流程，false 表示调用异常
 * @see CallReason
 */
public abstract boolean term(JCCallItem item, @CallReason int reason, String description);

JCCallItem item = call.getCallItems().get(0);
call.term(item, JCCall.REASON_NONE, null);

/**
 * 停止视频
 *
 * @param canvas JCMediaDeviceVideoCanvas 对象，由 startVideo 获得
 */
public abstract void stopVideo(JCMediaDeviceVideoCanvas canvas);

/**
 * 移除通话回调
 *
 * @param item          JCCallItem 对象
 * @param reason        通话结束原因
 * @param description   通话结束原因的描述，只有被动挂断的时候，才会收到这个值，其他情况下则返回空字符串
 */
void onCallItemRemove(JCCallItem item, @JCCall.CallReason int reason, String description);

public void onCallItemRemove(JCCallItem item, @JCCall.CallReason int reason, String description) {  // 移除通话回调
    if (mLocalCanvas != null) { // 本地视频销毁
        mContentView.removeView(mLocalCanvas.getVideoView());
        JCManager.getInstance().mediaDevice.stopVideo(mLocalCanvas);
        mLocalCanvas = null;
    }
    if (mRemoteCanvas != null) { // 远端视频销毁
        mContentView.removeView(mRemoteCanvas.getVideoView());
        JCManager.getInstance().mediaDevice.stopVideo(mRemoteCanvas);
        mRemoteCanvas = null;
    }
}

/**
 * 上报服务器拉取的未接来电
 *
 * @param item    JCCallItem 对象
 */
void onMissedCallItem(JCCallItem item);