# agora_iot_call.h (/zh-CN/api-reference/iot-apaas/device-sdk/call/make-call)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 引用文件 [#引用文件]
```c
#include "agora_iot_base.h"
```
## 函数 [#函数]
### agora_iot_call [#agora_iot_call]
```c
agora_iot_call_result_e agora_iot_call(agora_iot_handle_t handle, const char *peer, const char *extra_msg);
```
呼叫远端用户。
#### 参数 [#参数]
| 参数 | 描述 |
| --- | --- |
| [in] `handle` | [agora_iot_init](/zh-CN/api-reference/iot-apaas/device-sdk/call/config#agoraiotinit) 返回的 SDK 句柄。详见 [agora_iot_handle_t](/zh-CN/api-reference/iot-apaas/device-sdk/call/base#agoraiothandlet)。 |
| [in] `peer` | 应答呼叫的远端用户 ID。 |
| [in] `extra_msg` | 呼叫的附加信息。最大长度为 1024 字节(含 `'\0'`)。 |
#### 返回 [#返回]
[agora_iot_call_result_e](#agoraiotcallresulte) 中的枚举值。
### agora_iot_answer [#agora_iot_answer]
```c
agora_iot_call_result_e agora_iot_answer(agora_iot_handle_t handle);
```
应答远端用户发来的呼叫。
#### 参数 [#参数-1]
| 参数 | 描述 |
| --- | --- |
| [in] `handle` | [agora_iot_init](/zh-CN/api-reference/iot-apaas/device-sdk/call/config#agoraiotinit) 返回的 SDK 句柄。详见 [agora_iot_handle_t](/zh-CN/api-reference/iot-apaas/device-sdk/call/base#agoraiothandlet)。 |
#### 返回 [#返回-1]
[agora_iot_call_result_e](#agoraiotcallresulte) 中的枚举值。
### agora_iot_hang_up [#agora_iot_hang_up]
```c
agora_iot_call_result_e agora_iot_hang_up(agora_iot_handle_t handle);
```
拒绝远端用户发来的呼叫或挂断当前通话。
#### 参数 [#参数-2]
| 参数 | 描述 |
| --- | --- |
| [in] `handle` | [agora_iot_init](/zh-CN/api-reference/iot-apaas/device-sdk/call/config#agoraiotinit) 返回的 SDK 句柄。详见 [agora_iot_handle_t](/zh-CN/api-reference/iot-apaas/device-sdk/call/base#agoraiothandlet)。 |
#### 返回 [#返回-2]
[agora_iot_call_result_e](#agoraiotcallresulte) 中的枚举值。
## 常量 [#常量]
无
## 类型定义 [#类型定义]
### agora_iot_call_result_e [#agora_iot_call_result_e]
```c
typedef enum {
ERR_AG_CALL_SUCCESS = ERR_SUCCESS,
ERR_AG_CALL_FAILED = ERR_FAILED,
ERR_AG_CALL_INVALID_ARGUMENT = ERR_INVALID_ARGUMENT,
ERR_AG_CALL_PEER_BUSY = -100001,
ERR_AG_CALL_CAN_NOT_ANSWER = -100002,
ERR_AG_CALL_CAN_NOT_HANGUP = -100003,
ERR_AG_CALL_PEER_TIMEOUT = -100004,
ERR_AG_CALL_IS_CALLING = -100005,
ERR_AG_CALL_ILLEGAL_ANSWER = -100006,
ERR_AG_CALL_CAN_NOT_CALL_YOURSELF = -100007,
ERR_AG_CLOUD_REC_STARTED = -200001,
ERR_AG_CLOUD_REC_STOPPED = -200002,
ERR_AG_CLOUD_REC_NOT_PERMISSION = -200003,
ERR_AG_CLOUD_REC_PERMISSION_EXPIRED = -200004,
ERR_AG_CLOUD_REC_WITHOUT_APPID = -200005,
ERR_AG_CLOUD_REC_SERVER_NOT_ENABLE = -200006,
ERR_AG_ALARM_NOT_PERMISSION = -999997,
ERR_AG_ALARM_INVALID_ARGUMENTS = -999998,
ERR_AG_CALL_UNEXPECTEDLY_ERROR = -999999,
} agora_iot_call_result_e;
```
呼叫返回结果。
| 枚举值 | 描述 |
| --- | --- |
| `ERR_AG_CALL_SUCCESS` | 0:调用成功。 |
| `ERR_AG_CALL_FAILED` | -1:通用错误。 |
| `ERR_AG_CALL_INVALID_ARGUMENT` | -2:参数无效。 |
| `ERR_AG_CALL_PEER_BUSY` | -100001:本地用户无法重复呼叫。因为被呼叫的远端用户已经处于通话中。 |
| `ERR_AG_CALL_CAN_NOT_ANSWER` | -100002:本地用户无法应答呼叫。因为没有外来或发出的呼叫。|
| `ERR_AG_CALL_CAN_NOT_HANGUP` | -100003:本地用户无法挂断呼叫。因为本地用户不在呼叫中,也没有发送呼叫。 |
| `ERR_AG_CALL_PEER_TIMEOUT` | -100004:本地用户呼叫远端用户时等待超过 30 秒。 |
| `ERR_AG_CALL_IS_CALLING` | -100005: 已经有远端用户呼叫本地用户或本地用户已呼叫远端用户。|
| `ERR_AG_CALL_ILLEGAL_ANSWER` | -100006:错误的应答操作。例如本地用户应答从本地发出的呼叫。 |
| `ERR_AG_CALL_CAN_NOT_CALL_YOURSELF` | -100007:呼叫错误。因为本地用户无法呼叫自己。 |
| `ERR_AG_CLOUD_REC_STARTED` | -200001:云录制已经开始,无法再次开启。 |
| `ERR_AG_CLOUD_REC_STOPPED` | -200002:云录制已经停止,无法再次停止。 |
| `ERR_AG_CLOUD_REC_NOT_PERMISSION` | -200003:没有权限进行云录制。 |
| `ERR_AG_CLOUD_REC_PERMISSION_EXPIRED` | -200004:云录制权限已过期。 |
| `ERR_AG_CLOUD_REC_WITHOUT_APPID` | -100007:内部错误。 |
| `ERR_AG_CLOUD_REC_SERVER_NOT_ENABLE` | -100007:未开通声网灵隼服务。 |
| `ERR_AG_ALARM_NOT_PERMISSION` | -100007:呼叫错误。因为本地用户无法呼叫自己。 |
| `ERR_AG_ALARM_INVALID_ARGUMENTS` | -100007:呼叫错误。因为本地用户无法呼叫自己。 |
| `ERR_AG_CALL_UNEXPECTEDLY_ERROR` | -999999:未知错误。 |
### agora_call_mode_e [#agora_call_mode_e]
```c
typedef enum {
CALL_MODE_SINGLE = 1,
CALL_MODE_MUTLI = 2,
} agora_call_mode_e;
```
通话模式。
| 枚举值 | 描述 |
| :----------------- | :----------------------------------------- |
| `CALL_MODE_SINGLE` | 1: 单人模式。只允许一位用户与设备音视频通话。 |
| `CALL_MODE_MUTLI` | 2: 多人模式。允许多位用户与设备音视频通话。 |
### agora_iot_alarm_type_e [#agora_iot_alarm_type_e]
```c
typedef enum {
AG_ALARM_TYPE_VAD = 0,
AG_ALARM_TYPE_MOD = 1,
AG_ALARM_TYPE_OTHERS = 99
} agora_iot_alarm_type_e;
```
告警类型。
| 枚举值 | 描述 |
| --- | --- |
| `AG_ALARM_TYPE_VAD` | 0:语音监测。 |
| `AG_ALARM_TYPE_MOD` | 1:动作监测。 |
| `AG_ALARM_TYPE_OTHERS` | 99:其他告警类型。 |
### agora_iot_call_callback [#agora_iot_call_callback]
```c
typedef struct agora_iot_call_callback {
void (*cb_call_request)(const char *peer_id, const char *attach_msg);
void (*cb_call_answered)(const char *peer_id);
void (*cb_call_hung_up)(const char *peer_id);
void (*cb_call_local_timeout)(const char *peer_id);
void (*cb_call_peer_timeout)(const char *peer_id);
} agora_iot_call_callback_t;
```
SDK 呼叫事件回调。
#### cb_call_request [#cb_call_request]
在本地用户接收到远端用户呼叫时触发。
| 参数 | 描述 |
| --- | --- |
| [in] `peer_id` | 发送呼叫的远端用户账号。 |
| [in] `attach_msg` | 呼叫的附加信息。 |
#### cb_call_answered [#cb_call_answered]
本地用户发出的呼叫被远端用户应答时触发。
| 参数 | 描述 |
| --- | --- |
| [in] `peer_id` | 应答呼叫的远端用户账号。 |
#### cb_call_hung_up [#cb_call_hung_up]
本地用户发送的呼叫被远端用户拒绝。
| 参数 | 描述 |
| --- | --- |
| [in] `peer_id` | 拒绝呼叫的远端用户账号。 |
#### cb_call_local_timeout [#cb_call_local_timeout]
远端用户呼叫本地用户时,由于 30 秒内本地用户没有应答或拒绝操作导致超时。
你可以[联系技术支持](https://ticket.shengwang.cn)更改超时时间。
| 参数 | 描述 |
| --- | --- |
| [in] `peer_id` | 超时的远端用户账号。 |
#### cb_call_peer_timeout [#cb_call_peer_timeout]
本地用户呼叫远端用户时,由于 30 秒内远端用户没有进行应答或拒绝操作导致呼叫超时。
你可以[联系技术支持](https://ticket.shengwang.cn)更改超时时间。
| 参数 | 描述 |
| --- | --- |
| [in] `peer_id` | 超时的远端用户账号。 |