# register(注册)
#### 接口描述
SIP帐号注册。
#### 注意事项
- 已经建立与OpenEyeCall的WebSocket连接。
- 完成注册参数设置。
 
#### 方法定义
```
OpenEyeCall.prototype.register = function(sip_num, sip_name, sip_pwd, sip_mode, callbacks)
```
#### 参数描述
表1参数说明 
| 参数名       | 类型                                                             | 可选/必选 | 描述                                                                                    |
|:---|:---|:---|:---|
| sip_num   | String                                                         | 必选    | 用户号码。最大长度255个字符。 例："70942@example.com" |
| sip_name  | String                                                         | 必选    | 用户名，最大长度255个字符。                                                                       |
| sip_pwd   | String                                                         | 必选    | 密码，最大长度255个字符（明文）。                                                                    |
| sip_mode  | Int                                                            | 必选    | 组网模式,4:UAP组网;5:UAP pool组网                                                             |
| callbacks | [Callback] | 必选    | 回调方法。                                                                                 |
   
 表2Callback 
| 参数名               | 类型       | 可选/必选 | 描述                                                                                                                                             |
|:---|:---|:---|:---|
| response          | function | 必选    | 注册结果的回调方法。回调方法的入参请参考[表3]。                                                                  |
| onRegStatusUpdate | function | 必选    | 回调方法的入参请参考[表3][上报注册状态](https://support.huaweicloud.com/devg-openeye-cec/cec_05_1527.html)。 |
| onForceUnReg      | function | 必选    | 回调方法的入参请参考[表3]。                                                                            |
   
 表3回调方法的入参 
| 参数名         | 类型     | 描述                 |
|:---|:---|:---|
| description | String | 当前请求描述。            |
| result      | Number | 查询结果。0表示成功，其他表示失败。 |
| rsp         | Number | 内部消息编号。            |
   
![](https://support.huaweicloud.com/devg-openeye-cec/public_sys-resources/note_3.0-zh-cn.png)
回调接口调用成功，并不表示注册成功，需要根据[上报注册状态](https://support.huaweicloud.com/devg-openeye-cec/cec_05_1527.html)判断是否注册成功。
回调方法的入参示例：
```
{
   "description" : "tsdk_login",
   "result" : 0,
   "rsp" : 65537
}
接口重复调用，且账号与已注册账号不一致时：
{
    "description": "tsdk_login",
    "result": 1,
    "rsp": 66537,
    "errMsg": "Repeat login, current user:88880899"
}
```
#### 使用示例
```
function register() {
    global_openEye_SDK.openEyeCall.register("70942@example.com", "70942@example.com", "1qaz@WSX", 4, {
        onRegStatusUpdate: onRegStatusUpdate,
        onForceUnReg: onForceUnRegInfo,
        response: registerResponse
    });
}
function onRegStatusUpdate(data){
    console.info(data);
}
function onForceUnReg(data){
    console.info(data);
}
function registerResponse(data) {
    if (data.result == 0) {
        console.info("Register Operation Success");
    } else {
        console.error("Register Operation Failed");
    }
}
```