简体中文| English
本例程演示了如何通过乐鑫 ESP32-S3 Korvo V3 开发板和一个安卓手机，模拟一个典型的视频门铃场景，可以演示按门铃键呼叫手机 APP 端，APP 端接听；或是手机 APP 实时查看门铃端的摄像头画面。
├── CMakeLists.txt
├── components Agora iot sdk component
│ ├── agora_iot_sdk
│ │ ├── CMakeLists.txt
│ │ ├── include Agora iot sdk header files
│ │ │ ├── agora_iot_api.h
│ │ │ └── agora_iot_call.h
│ │ └── lib
│ │ ├── esp32
│ │ │ └── PLACEHOLDER
│ │ ├── esp32s2
│ │ │ └── PLACEHOLDER
│ │ └── esp32s3 Agora iot sdk libraries
│ │ ├── libagora-cjson.a
│ │ ├── libagora-iot-solution.a
│ │ ├── libagora-mbedtls.a
│ │ ├── libagora-webclient.a
│ │ ├── libahpl.a
│ │ ├── libhttp-parser.a
│ │ ├── libiot-license.a
│ │ ├── libiot-utility.a
│ │ ├── libmedia-engine.a
│ │ ├── librtsa.a
│ │ └── PLACEHOLDER
│ └── camera Camera component
├── firmware
│ ├── ag_videodoorbell_esp32.bin
│ ├── bootloader.bin
│ └── partition-table.bin
├── main Video doorbell Demo code
│ ├── app_config.h
│ ├── CMakeLists.txt
│ ├── Kconfig.projbuild
│ └── video_doorbell.c
├── partitions.csv partition table
├── README.en.md
├── README.md
├── sdkconfig.defaults
└── sdkconfig.defaults.esp32s3
本例程目前仅支持ESP32-S3-Korvo-2开发板。
摄像头推荐采用OV5660，外接一个扬声器。摄像头需要具有自动对焦特性，否则二维码配网功能不可用，可以采用ESP32的蓝牙配网或者代码中固定wifi相关信息
乐鑫ESP物联网开发框架（ESP-IDF）。安装方法详见 官方文档(https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html#id8)。
本例程支持 IDF release/v[4.4] 及以后的分支，例程默认使用 IDF release/v[4.4] 分支（commit id: 00396a9d495514986fd4fbfbd51e60fc8e4960e3)
选择 IDF 分支的方法，如下所示：
cd $IDF_PATH
git checkout release/v4.4
git pull
git submodule update --init --recursive乐鑫ESP音频应用开发框架（ESP-ADF）。安装方法详见乐鑫音频应用开发指南(https://docs.espressif.com/projects/esp-adf/zh_CN/latest/get-started/index.html)。
本例程支持 ADF master分支（commit id: 6a977ad9d252738ecf672b154450d450b5e01a70)
本例程还需给 IDF 合入1个 patch， 合入命令如下： cd $IDF_PATH git apply $ADF_PATH/idf_patches/idf_v4.4_freertos.patch
将本例程（agora-demo-for-esp32）目录拷贝至 ~/esp 目录下。请运行如下命令：
$ export ADF_PATH=~/esp/esp-adf
$ . $HOME/esp/esp-idf/export.sh
$ cd ~/esp/agora-demo-for-esp32
$ idf.py set-target esp32s3
$ idf.py menuconfig
$ idf.py build请运行如下命令：
$ idf.py -p /dev/ttyUSB0 flash monitor注意：遇到 /dev/ttyUSB0 权限问题，请执行 sudo usermod -aG dialout $USER
下载成功后，本例程会自动运行，待初始化完成后，可以看到串口打印："Agora: Press [REC] key to ring the doorbell ..."。此时设备处在 低功耗保活状态
（TBD）
您也可以跳过以上的步骤，直接下载本例程中预编译好的固件。
请运行如下命令：
esptool.py --chip esp32s3 \
--port /dev/ttyUSB0 --baud 921600 \
--before default_reset \
--after hard_reset write_flash -z --flash_mode dio --flash_freq 80m --flash_size detect \
0x0 ./firmware/bootloader.bin \
0x8000 ./firmware/partition-table.bin \
0x10000 ./firmware/ag_videodoorbell_esp32.bin（TBD）
详见《开通声网灵隼服务》。
设备端 SDK 通过 License 对设备鉴权。License 与设备绑定，一个 License 在同一时间只能绑定一个设备。
声网为每位开发者发放 10 个有效期 6 个月的免费测试 License，你需要联系 iot@agora.io 申请免费 License，或直接购买商业 License。
你可以简单修改ESP32 S3 Turnkey Demo相关参数配置，使用自己创建产品参数配套Demo效果。
设备端Demo源码中，你只需要修改main/app_config.h中的以下参数即可：
#define CONFIG_AGORA_APP_ID "4b31f****************************3037"
#define CONFIG_CUSTOMER_KEY "8620f******************************7363"
#define CONFIG_CUSTOMER_SECRET "492c1****************************e802"
#define CONFIG_MASTER_SERVER_URL "https://app.agoralink-iot-cn.sd-rtn.com"
#define CONFIG_SLAVE_SERVER_URL "https://api.agora.io/agoralink/cn/api"
#define CONFIG_PRODUCT_KEY "EJIJ**********5lI4"
#define CONFIG_LICENSE_PID "00F8*****************************D646" / 从市场销售处申请获取 */
以上参数你均可从灵隼管理平台应用配置>>开发者选项页面中获取。
参数修改完毕后，参考编译和烧录步骤构建自己的ESP32 Turnkey Demo，对应的APP端Demo开发方式请参考对应的Android端文档和IOS端文档。
打开安装的自定义应用，进入注册/登录界面，输入账号和密码 -> 点击 登录。
点击‘添加设备’，进入扫码设备二维码界面。
扫码设备的二维码后，进入wifi用户名和密码输入界面。
输入wifi用户名和密码后点击完成，手机屏幕出现二维码。
设备对准手机的二维码进行扫码。
扫码成功，手机app中点击完成，即设备添加成功。
打开安装的自定义应用，进入注册/登录界面，输入账号和密码 -> 点击 登录。
回到开发板（门铃端），再次确认上述的固件编译、下载步骤已经完成，并看到串口每隔几秒打印出："Agora: Press [REC] key to ring the doorbell ..."
按一下 [REC] 按键，对 APP对应的用户进行呼叫。
APP 会出现被呼界面，显示 有人按门铃，并等待接听。同时已经可以看到门铃端的实时画面，听到门铃端的声音，但此时无法和门铃端对话。
在 APP端点击 接听，随即就能和门铃端实时对讲了。
在 APP端点击 挂断，结束和门铃端的通话。
说明：在按 [REC] 键呼叫远端APP前，门铃处于低功耗保活状态，典型功耗在 800uA 以下。呼叫后门铃自动切换到全功耗模式
打开安装的自定义应用，进入注册/登录界面，输入账号和密码 -> 点击 登录。
回到开发板（门铃端），再次确认上述的固件编译、下载步骤已经完成，并看到串口每隔几秒打印出："Agora: Press [REC] key to ring the doorbell ..."
在我的设备中看到当前账号添加的设备，点击待通话的设备。
随即就能看到门铃端的实时画面了，APP端出图时间通常在 1 秒左右。
点击APP的电话按钮，就可以和门铃端实时对讲。
声网音视频物联网平台方案，依托声网自建的底层实时传输网络 Agora SD-RTN™ (Software Defined Real-time Network)，为所有支持网络功能的 Linux/RTOS 设备提供音视频码流在互联网实时传输的能力。该方案充分利用了声网全球全网节点和智能动态路由算法，与此同时支持了前向纠错、智能重传、带宽预测、码流平滑等多种组合抗弱网的策略，可以在设备所处的各种不确定网络环境下，仍然交付高连通、高实时和高稳定的最佳音视频网络体验。此外，该方案具有极小的包体积和内存占用，适合运行在任何资源受限的 IoT 设备上，包括乐鑫 ESP32 全系列产品。
请按照下面的链接获取技术支持：
- 如果发现了示例代码的 bug，欢迎提交 issue
- 如果有其他疑问，也可以直接联系门铃方案负责人（微信：JJ2dog）
我们会尽快回复。
