快速开始

/**
 * 创建 JCClient 实例
 *
 * @param appKey      用户从 菊风云 平台上申请的 AppKey 字符串
 * @param callback    回调接口，用于接收 JCClient 相关通知
 * @param extraParams 额外参数，没有则填null
 * @return JCClient 对象
 */
public static JCClient create(Context context, String appKey, JCClientCallback callback, Map<String, String> extraParams)

public boolean initialize(Context context) {
    // 初始化各模块，因为这些模块实例将被频繁使用，建议声明在单例中
    JCClient client = JCClient.create(Context, "your appkey", this, null);
    return true;
}

/**
 * 设置配置相关参数<br>
 * CONFIG_KEY_SERVER_ADDRESS, CONFIG_KEY_HTTPS_PROXY 均需要在 login 之前调用<br>
 *
 * @param key    参数关键字
 * @param value  参数值
 * @return 返回 true 表示设置成功，false 表示设置失败
 * @see JCClient.ConfigKey
 */
public abstract boolean setConfig(@ConfigKey String key, String value);

/**
 * 服务器地址
 */
public static final String CONFIG_KEY_SERVER_ADDRESS = "config_key_server_address";
/**
 * 设备id
 */
public static final String CONFIG_KEY_DEVICE_ID = "config_key_device_id";
/**
 * https代理, 例如 192.168.1.100:3128
 */
public static final String CONFIG_KEY_HTTPS_PROXY = "config_key_https_proxy";

JJCClient client = JCClient.create(Context, "your appkey", this, null);
// 设置登录地址（国内环境）
client.setConfig(JCClientConfigServer, "http:cn.router.justalkcloud.com:8080");
 // 设置登录地址（国际环境）
client.setConfig(JCClientConfigServer, "http:intl.router.justalkcloud.com:8080");

/**
 * 获取配置相关参数
 *
 * @param key 参数关键字
 * @return 成功返回字符串类型具体值, 失败返回 NULL
 * @see JCClient.ConfigKey
 */
public abstract String getConfig(@ConfigKey String key);

JJCClient client = JCClient.create(Context, "your appkey", this, null);
// 获取登录配置
client.getConfig(JCClientConfigServer);

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

client.login(userI, password);

/**
 * 登录结果回调
 *
 * @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;

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

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

/**
 * 登录状态变化通知
 *
 * @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 foreground 是否为前台
 */
public abstract void setForeground(boolean foreground);

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

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

// 发起语音呼叫
call.call("peer number", false, "自定义透传字符串");

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

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

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

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

/**
 * 挂断
 *
 * @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 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) {  // 移除通话回调
   //界面处理
}