##############  Chinese  ##############

### 功能介绍

萤石开放平台SDK是由杭州萤石网络股份有限公司（下称“萤石”或“我们”）推出的，为移动、PC应用开发者提供视频预览、录像回放和消息接收等能力的软件开发工具包（SDK）；开发者在其应用内集成萤石开放平台SDK后，可通过萤石开放平台向其应用的最终用户（下称“最终用户”）提供监控设备远程查看、管理的相关功能。本SDK仅对开发者提供调用，与最终用户无交互对话界面。

### 目录

- EZOpenSDK_harmony_v**：示例代码工程，Demo运行步骤如下:
  
        1.项目根目录-AppScope-app.json5文件，将bundleName修改为自己的包名
        2.点击IDE右上角Project Structure-Project-Signing Configs，配置自己的证书文件
        3.Run 'entry'
- EZOpenSDK.har:SDK包
- ezopensdk-harmony-skill：AI辅助开发文档，供AI编程工具（如Kiro、Cursor等）使用，帮助AI更好地理解SDK接口和业务逻辑。
- README.text：集成必读文档，一些说明及注意事项。
- ReleaseNotes.text：发布说明。

### 注意事项

    1.用async修饰的api调用时必须加await（包括父级链路上的调用），否则可能因为时序问题出现异常

### 集成指南

    1.SDK复制到项目中：entry下创建libs文件夹，将EZOpenSDK.har复制到libs下
    2.依赖修改：entry下oh-package.json5下配置dependencies: {"@ezviz/ezopensdk": "file:./libs/EZOpenSDK.har"}，参考demo
    3.配置修改：entry下build-profile.json5下配置enableOverride=true，参考demo
    4.配置修改：工程目录下的build-profile.json5下配置useNormalizedOHMUrl=true，参考demo

### ohpm安装指南（暂不支持）

    ohpm i @ezviz/ezopensdk

### SDK升级替换包

    1.新SDK复制到项目中：将EZOpenSDK.har复制到libs下，overwrite之前包
    2.Build-Clean Project
    3.File-Sync and Refresh Project

### 常用文档链接

    集成文档：https://open.ys7.com/help/4217
    错误码文档：https://open.ys7.com/help/37
    发布日志文档：https://open.ys7.com/help/3761
    Demo apk使用指南：https://open.ys7.com/help/4148
    SDK常见问题指南：https://open.ys7.com/help/4146

##############  English  ##############
