#APP功能介绍

[TOC]

一、关于Kalay APP

1.1 简介

Kalay1.0标准-升级版APP是TUTK Kalay平台的产品之一，是针对网络摄像机等智能终端监控场景移动所量身定制的App，不论是单通道设备（如IPCamera、可视门铃、低功耗网络摄像机等），或者是多通道/多镜头设备（如DVR/NVR等）多种类型的设备均有支持兼容。此App具备完整的操作与设定功能，包含实时视频观看、单向/双向语音对讲、设备SD卡录像回放、分辨率切换、摄像机设置等功能，让使用者可随时随地在移动装置上远程观看与操作网络摄像机。

1.2 基本规格

类型	基础规格	补充说明
视频格式	MPEG4、H.264、MJPEG、HEVC、VP8、VP9	默认采用硬解码，失败后自动切换为软解，可通过API设定软硬解方式。建议采用H.264 /H.265
音频格式	G711U、G711A、ADPCM、PCM、Speex、MP3、G726、AAC	支持8K/16K/22K/48K、8bit/16bit; 但不包含AAC授权，如有需要请自行取得AAC授权许可后使用。
支持分辨率	无最高分辨率限制	但会因不同硬件规格和网络带宽等影响实际出图效果。建议2K(2560x1440) /20fps最佳。
系统要求	Android 7.0及以上；IOS 10.0及以上	适配iPhone & Android手机。iOS支援CPU架构：armv7、arm64、x86_64；Android支援CPU架构：armeabi-v7a、arm64-v8a、x86、x86_64
推送平台	极光/华为/小米/VIVO/OPPO/魅族/FCM(Android)、APNS(IOS)	Android推送根据需要对接，部分手机厂商对接推送要求应用上架，需注意。

1.3 相关参数

码流：根据当前网络的上传带宽、分辨率、帧率以及对画质的要求需设备端自行调整码流，RLY模式下建议：720P不超过1Mbps，480P不超过750kbps, 360P不超过500kbs。FPS在10~20fps之间，取中值15fps左右。 P2P/LAN模式下，bps和fps可以往上调，以获得更好的画质和流畅度体验。
分辨率：实际无最高分辨率限制，最佳效果支持2K（2560x1440）/20fps分辨率，亦可调至500W像素，实际效果将因手机和设备的性能有差异。

1.4 支援语言（附语言表）

公版设计已支援三种语言：英文、简体中文、繁体中文。如需要增加此三种以外的语言，可参考《Kalay APP翻译对照表》进行翻译后，新增到App。

1.5 适配SDK版本号

SDK 4.3.x（可实现分区分流设定、支持P2P/Nebula协议、支持Authkey/支持DTLS）

1.6 App版本号

在App的侧边栏进入关于界面，可查看到当前App版本号，以及App使用的IOTCAPIs版本号和AVAPIs版本号。

1.7 更换LOGO和UI

在TUTK公版 Kalay APP的基础上进行更换APP Logo和UI，可参照标准文件提供相应素材。（详见《Kalay APP更换Logo标准文件》）

1.8 业务流程概述

请参考 [#架构及功能模块][#架构及功能模块] 介绍。

二、功能对接

2.1 标准功能

请参考 [#架构及功能模块][#架构及功能模块] 介绍。

2.2 功能对接

设备需要依据TUTK提供的IO Command文档进行功能对接。（详见 [IO Command Definition][IO Command Definition] ）。 > 注：为规范公版Kalay APP IO Command的设定和使用，禁止随意更改公版IO Command已制定的参数和结构体，如因随意更改造成设备无法成功对接公版APP，TUTK无需承担任何责任。同时，为满足客制化项目的需求，将预留部分参数区段以供客制化Command的设定。

2.3 部分源代码

部分源代码（Partial Source Code）及相关文件均属TUTK所有，通常不对外开放，如已购买TUTK Kalay1.0标准-升级版部分源代码，可参考 [#API调用说明][#API调用说明] 进行开发。

三、新增设备

新增设备可透过设备列表页面下方的“＋”号，选择对应的添加方式进行新增。新增设备流程如下： ![Kalay1.0升级版添加设备流程](https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=ca113efad1ba60f33d7d57aaf7b2364a "Kalay1.0添加设备")

3.1 新增未连接到路由器的设备

将设备配置到某个路由（Wi-Fi）下，有以下两种方式供选择，根据设备支援的方式进行选择。

3.1.1 二维码配网

点击“＋”号，在弹出选项中，选择：Not been connected to the router；
进入“Set Up Device”页面，选择“二维码配网”方式；
扫描设备的UID二维码获取指定的设备信息，并进入添加设备页面；
输入设备密码（或者Token）；
如设备采用authkey，需再开启authkey开关后输入正确的authkey，APP与设备建立连接；
点击“确认”，APP尝试与设备连线，并将进行如下判断：

a.输入栏位是否填写完毕？

否 —>提示：请输入所有选项；
是 —>进入下一步判断；

b.连线是否成功？

否，密码错误 —>提示：密码错误；
否，Token错误 —>提示：添加失败，请检查输入的token是否正确；
否，authkey错误 —>提示：添加失败，请检查输入的authkey是否正确；
否，设备离线 —>提示：联机超时；
是 —>进入下一步。
- 手机获取系统当前连接的wifi，确认输入此wifi的密码后，点击“生成二维码”；
- 按照提示将摄像机镜头对准二维码进行扫描，获取wifi/密码等配网信息；
- 确认设备状态已成功进入配网程序并连接网络后，点击“下一步”；
- App尝试与设备连线成功，并完成设备添加流程。

3.1.2 AP直连配网

点击“＋”号，在弹出选项中，选择：Not been connected to the router；
进入“Set Up Device”页面，选择“AP直连配网”方式；
去系统WIFI设置连接上设备的AP热点后，返回APP；
点击“下一步”，APP将进行如下判断：

a.手机当前连接Wifi是否可出外网？

是 —>提示“未成功切换至设备wifi”；
否 —>开始自动搜索设备UID；

b.搜索设备UID是否成功？

是，且只有1个UID —>成功跳转添加设备界面；
是，但大于1个UID —>提示：“未成功切换至设备wifi”；
否 —>提示：“无法找到该设备，请重试”。
- 输入设备密码（或者Token）；
- 如设备采用authkey，需再开启authkey开关后输入正确的authkey，APP与设备建立连接；
- 弹出是否需要给设备配置网络的对话框，并执行如下行为： a.否：APP请求添加设备至服务器成功并返回设备列表，结束此流程。 b.是：进入配置网络页面，APP获取设备周边可配置的网络；
- 用户选择设备要添加的网络并输入网络密码，APP发送WiFi/SSID及密码给设备；
- 等待设备配置到选定的WiFi，APP与设备建立连线成功；
- App尝试与设备连线成功，并完成设备添加流程。

3.2 新增已连接到路由器的设备

点击“＋”号，在弹出选项中，选择：Been connected to the router
默认进入本地搜索界面，有以下三种输入UID的方式：

3.2.1 本地搜索

本地搜索即局域网搜索，是在手机当前wifi下进行搜索的结果。

在搜索的UID列表中选择设备对应的UID；
进入添加设备界面，输入设备密码（或者Token）和名称；
如设备采用authkey，需再开启authkey开关后输入正确的authkey；
点击右上角“确认”按钮，APP与设备建立连线成功，并请求添加设备至服务器；
添加成功，返回设备列表。

（出现在局域网下搜索不到设备的现象，可参考 [第十章 FAQ问题10.4][10.4] ）

3.2.2 扫描二维码

APP可通过扫描设备UID生成的二维码进行添加。

点击“扫码”按钮，进入扫码界面；
扫描设备UID生成的二维码，或者点击“Select QRCode form album”去手机相册中选择二维码进行识别；
扫码成功后进入添加设备界面；
输入设备密码（或者Token）和名称；
如设备采用authkey，需再开启authkey开关后输入正确的authkey；
点击右上角“确认”按钮，APP与设备建立连线成功，并请求添加设备至服务器；
添加成功，返回设备列表。

3.2.3 手动输入UID

APP可通过直接输入设备UID进行添加。

点击“手动输入”按钮，进入添加设备界面；
输入设备密码（或者Token）和名称；
如设备采用authkey，需再开启authkey开关后输入正确的authkey；
点击右上角“确认”按钮，APP与设备建立连线成功，并请求添加设备至服务器；
添加成功，返回设备列表。

四、首页

在首页，可查看本地设备列表，切换设备列表的显示方式，还可点击进入侧边栏和手机相册。

4.1 设备列表

设备列表是所有已被添加设备的清单，设备按照被添加的时间先后顺序从上往下排列。设备列表截图上主要显示：设备名称、二维码分享和设备设置。

4.1.1 设备列表截图及刷新

设备列表截图取自设备实时监控画面。点击截图可进入相应设备的liveview界面。刷新截图的方式：在查看设备Liveview后退回设备列表时会抓取最后一帧图片显示在设备列表。

4.1.2 设备二维码分享

设备列表截图左下角显示分享按钮，点击按钮可生成设备UID的二维码。 > 注：此功能与账号无关，不同于透过账号分享设备的功能。

4.1.3 设备设置

点击“设置”按钮可进入该设备的设置页面，详细功能说明详见 [第六章设备设置功能][p6]。

4.2 多通道页面

点击右上角“多通道”按钮，可以切换至多通道页面，该页面默认呈现四分割画面，按照加载的通道先后顺序排列显示，可通过左右滑动页面查看所有加载通道。多通道截图上主要显示通道名称、通道状态和全屏按钮。

4.2.1 多通道截图及刷新

多通道截图取自该通道的实时监控画面。点击“全屏”按钮可进入相应通道的liveview界面。刷新截图的方式：在查看此通道的Liveview后退回设备列表时会抓取最后一帧图片显示在多通道页面上。

4.2.2 通道状态及刷新

通道状态与此设备连线状态保持一致。在多通道画面上显示的状态主要有：在线/Online、离线/Offline、连接中/Connecting和密码错误/Password Error四种状态。设备连线状态刷新有如下两种方式：

每次进入多通道页面：每次点击右上角“多通道”按钮进入该界面会更新相应设备的连线状态。
按钮刷新：点击非在线设备的刷新按钮可进行重连以更新状态。

（详细的状态说明以及应对措施，可参考[第十章 FAQ问题10.1][10.1]）

4.2.3 密码检测机制

在多通道页面上，对在线设备进行画面预览，首先需点击画面上的三角播放按钮。首次添加设备时APP会先进行一次密码检测，判断设备密码是否符合APP设定的整体密码规则。当设备密码不符合规则时，App弹出提示修改密码对话框，建议使用者设定符合安全要求的设备密码。使用者可以选择进行设备密码修改，或跳过。如果选择“跳过”，之后将不再对该设备进行密码安全检测。

密码检测和设定规则：

设备当前密码是否正确；
设备当前密码非默认出厂密码admin或重复数字（例如：888888/000000）
密码不得为空;
密码长度限制8~20位；
要求英文字母+数字混合输入，不支持中文字符和特殊符号。

4.2.4 加载/移除通道

点击多通道页面上的+号，进入Select Channel页面选择需要加载/移除的Channel，保存后将会按照列表顺序依次排列显示在多通道页面上。无法在多分割画面上直接删除或者加载某个通道，如果需要删除或者加载某个通道，可通过进入Select Channel重新勾选并确认。

4.3 侧边栏

在侧边栏界面，可进入关于界面，查看APP当前的版本号和SDK版本号等资讯。还可以查看APP用户协议和隐私政策说明。

五、设备实时预览

在本地设备列表点选要查看的设备，App将跳转到liveview界面并开始与设备进行连线。

5.1 设备连线状态及刷新

实时画面状态主要有：在线/Online、离线/Offline、连接中/Connecting和密码错误/Password Error四种状态。设备连线状态刷新有如下两种方式：

每次进入liveview界面：每次点击进入该界面会更新相应设备的连线状态。
按钮刷新：点击非在线设备的刷新按钮可进行重连以更新状态。

（详细的状态说明以及应对措施，可参考[第十章 FAQ问题10.1][10.1]）

5.2 密码检测机制

对在线设备进行画面预览，首先需点击画面上的三角播放按钮。首次添加设备时APP会先进行一次密码检测，判断设备密码是否符合APP设定的整体密码规则。当设备密码不符合规则时，App弹出提示修改密码对话框，建议使用者设定符合安全要求的设备密码。使用者可以选择进行设备密码修改，或跳过。如果选择“跳过”，之后将不再对该设备进行密码安全检测。

密码检测和设定规则：

设备当前密码是否正确；
设备当前密码非默认出厂密码admin或重复数字（例如：888888/000000）
密码不得为空;
密码长度限制8~20位；
要求英文字母+数字混合输入，不支持中文字符和特殊符号。

5.3 设备唤醒功能

唤醒功能是针对低功耗设备（例如低功耗门铃、低功耗IPC等）进行设计的独特功能。在设备列表界面点击相应设备，APP跳转到liveview界面时将开始唤醒设备，并在画面左上方显示目前设备的状态。

5.4 观看实时影像

在liveview界面，点击画面上的三角播放按钮，方可观看设备的实时影像。点击画面右下方切换按钮，可进行监控画面横屏切换。IOS可通过上方导航栏返回键切回竖屏状态，Android可通过手机虚拟返回键切回竖屏状态。两指操作可对实时画面进行缩放。 > 注：实时画面持续播放的时长建议不超过30min,如用户持续观看实时画面30min后，APP将会弹出相应提示：您已观看实时画面30min，是否需要继续观看？

（影响实时画面出图及原因，可参考 [第十章 FAQ问题10.2][10.2]）

5.4.1 对讲及监听

打开喇叭,监听设备周围的声音；打开麦克风,可与设备端沟通。此App只可支持双向语音对讲，即同时开启监听和麦克风功能。App支援的音频格式参考第一章。

（监听和对讲出现噪音的原因，详见 [第十章 FAQ问题10.3][10.3]）

5.4.2 拍照及录像

拍照和录像功能是针对设备传输过来的实时画面进行截图和录像；照片和录像默认存储在用户手机相册中。APP限制本地录像时长为3分钟，手机存储空间小于300MB时，APP会弹出相应提示：储存空间不足。用户须在手机权限设置里面开启：允许App访问手机相册。

5.4.3 镜像及翻转

镜像和翻转功能可以设置设备传输过来的实时画面的显示角度。点击镜像设置后，正常显示的画面将进行垂直180°翻转；点击翻转设置后，正常显示的画面将进行水平180°翻转。功能可用前提：设备与App连接状态为在线且正在观看实时画面、设备支援此功能、设备成功对接此功能的IO Command。如果APP检测到该设备不支持镜像/翻转功能，按钮将置灰显示。

5.4.4 分辨率/QVGA

QVGA功能可以设置设备传输过来的实时画面的分辨率大小。目前可支持的分辨率选项有：高清、标清、流畅三种。功能可用前提：设备与App连接状态为在线且正在观看实时画面、设备支援此功能、设备成功对接此功能的IO Command。

5.4.5 云台控制/PTZ

对PTZ进行控制的方式有如下三种：

通过手势在画面区域上滑动上下左右方向来控制设备进行云台转动。
通过点击画面区域左下角PTZ按钮，切换出方向控制面板来控制设备进行云台转动。方向控制面板可实现"单击"和"长按"两种操作：单击某个方向键可向设备发送一次转向请求；长按某个方向键可向设备每隔1s持续发送转向请求。

功能可用前提：设备与App连接状态为在线且正在观看实时画面、设备支援此功能、设备成功对接此功能的IO Command。

5.4.6 滤镜/Filter

APP启用的滤镜功能主要用于改变解码图像的渲染效果。目前默认启用了三种滤镜效果：原画、美白、黑白。

5.4.7 切换通道画面

在Liveview页面支持切换该设备的其他通道进行实时影像的观看，如果此设备可支持多通道，则通过点击右上角的“CH”按钮即可进行切换。

六、设备设置功能

从设备列表点击缩略图右下角的设置按钮，可进入设备设置界面。当设备处于非online状态，设置页面只有“移除设备”可操作。

（设置界面常见提示/Error Message说明，可参考 [第十章 FAQ问题10.5][10.5]）

6.1 更改名称/Change Name

修改设备名称或者通道名称。功能可用前提：设备无需做特殊支援，因为设置保存在APP,不会透过IO Command设置。

6.2 更改密码/Change Password

添加设备时根据是否采用Device Token，会自动显示或者隐藏此功能。当设备未启用Token时，可更改设备密码。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。修改设备密码时，点击“确认”按钮，App将进行如下判断：

    a.是否输入所有栏位？
    - 否 —&gt;提示：“请输入所有选项”；
    - 是 —&gt;进行下一步判断；

    b.旧密码是否正确？
    - 否 —&gt;提示：“旧密码输入错误。”
    - 是 —&gt;进行下一步判断；

    c.新密码是否符合规则？
    - 否 —&gt;提示：“请输入8到20位英文字母和数字混合密码。”
    - 是 —&gt;进行下一步判断；

    d.新密码和旧密码是否一致？
    - 否 —&gt;提示：“新密码不可以和旧密码相同。”
    - 是 —&gt;进行下一步判断；

    e.新密码和确认密码是否一致？
    - 否 —&gt;提示：“两次输入的新密码不一致。”
    - 是 —&gt;提示：“恭喜！密码已更新成功。”

6.3 网络设置/Wi-Fi Setting

进行WiFi设定，可以给设备切换至其他网络。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.4 录像模式/Recording Mode

设定设备录像模式：关闭/全时录像/移动侦测录像全时录像开启时，设备将持续24小时不间断录制视频影像至SD卡中。移动侦测开启时，设备仅在侦测到物体移动时录制视频影响至SD卡中。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.5 移动侦测设置/Event settings

设定是否开启设备侦测功能，以及设备侦测的灵敏度高低。移动侦测开启时，设备将在侦测到物体移动时录制视频，或发出告警通知，具体行为根据对接设备的设计而决定。移动侦测的灵敏度设置，将改变设备对物体移动幅度的识别程度。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.6 调试模式/Debug Mode

详见 [第九章调试模式][p9]。

6.7 同步时间/Sync Time

点击同步时间按钮，APP将手机当前的时间发送给设备，设备将进行同步。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.8 报警推送开关

报警推送开关的开启或关闭，可以控制APP是否接收相应设备的推送通知。功能可用前提：设备有开通KPNS推送功能。

6.9 SD卡信息/格式化

点击查看SD卡信息，进入相应界面。APP将获取当前设备SD卡的全部空间和可用空间。使用者可点击进行格式化SD卡操作，这将清除掉设备SD卡上的所有资讯。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.10 人形侦测开关

通知设备启用人形侦测，当镜头捕捉到有人经过时录制视频，或发出告警通知，具体行为根据对接设备的设计而决定。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.11 夜视开关

通知设备启用夜视，傍晚来临时，启用夜视功能能够更好地捕捉夜间的景色，增加物体成像的清晰的。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.12 夏令时开关

通知设备启用夏令时。功能可用前提：设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

6.13 设备信息/OTA

App呈现设备的型号、厂商和当前固件版本号，这些信息来源于设备。同时针对开通了OTA功能的设备，App会向OTA服务器确认是否存在最新固件版本，如果发现最新固件版本与设备当前固件版本不一致，将会建议客户进行固件升级。

功能可用前提：

设备与App连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。
已申请开通OTA服务，且已完成固件升级文件的上传和发布。

（OTA升级出现异常提示/Error Message说明，可参考 [第十章 FAQ问题10.8][10.8]）

6.14 删除设备

将设备从App移除，执行此操作后，设备列表/多通道画面将不再显示相应设备，且手机将不能再收到该设备的推送消息。

七、SD卡事件列表及回放

远端事件回放主要是获取并播放设备存储在SD卡中的录像。当设备处于在线(Online)状态时，可点击liveview界面左下角按钮进入事件列表。如APP从设备端未获取到任何事件，则APP提示：未找到任何记录。

7.1 搜索事件列表

App搜索事件的时间规则：

录制事件的时间会以设备当前时间为基准。App默认搜索手机系统当前时区24小时内的录像。
搜索指定时间段：点击Event界面右上角的搜索按钮，选择需要的时间段进行搜索。
App上录像类型可分两种类型呈现：全时录像和移动侦测。

7.2 播放事件

根据列表中显示的时间点，选择想查看的录像，点击单个事件信息区域，进入播放界面。已正常播放录像，事件列表显示录像画面截图；未播放录像，截图显示默认预设图片。

（在进行事件播放时，也可能会出现多种异常状况，异常状况的说明以及原因可参考 [第十章 FAQ问题10.6][10.6]）

八、报警消息推送

在设备开启移动侦测及报警推送，且设备被事件触发，发送通知至KPNS Server，由KPNS推送至第三方推送平台（APNS/FCM/极光/手机厂商推送平台），再由第三方将讯息推送到用户的手机上。

不同手机系统/品牌采用第三方推送服务的差异：

Android已支援的手机厂商推送平台，包括：华为、小米、VIVO、OPPO和魅族（仅CN版本）。
在中国大陆区域内启动的Android应用，会自动检测手机品牌走相应的厂商推送平台，如手机品牌不在以上支援的范围，将走极光免费版推送。
在非中国大陆区域启动的Android应用，采用FCM推送。
iOS应用均使用APNS推送。

8.1 消息推送设定

满足以下条件，手机才能正常收到推送：

设备成功对接KPNS Server：在KPNS Server上可查到设备成功注册信息;(新版KPNS版本不再要求设备注册这一步)
设备使用的UID在KPNS Server白名单中；
设备被触发并发送事件到KPNS Server：在KPNS Server上可查到设备推送Log；
手机成功添加设备并Mapping成功：在KPNS Server上可查询到手机与设备Mapping信息；
手机开启允许接收App推送通知；
第三方推送平台成功传送信息（不可控）

（如以上条件均满足时，部分安卓手机仍旧无法收到推送消息，则可能与安卓系统设置有关，可参照 [第十章 FAQ问题10.7][10.7]进行相应操作。）

8.2 消息推送类型

目前Kalay有针对两种设备推送的事件类型进行处理。

移动侦测：对应KPNS Sever上的Event Type = 1。主要针对设备在检测到物体移动时发起的侦测推送。
门铃呼叫：对应KPNS Sever上的Event Type = 2000。主要针对门铃设备被按下门铃按钮时发起的门铃呼叫推送。

> 注：其他消息推送类型未做特别处理，如有增加需要额外对接。

8.3 查看推送通知

根据不同的设备类型，以及APP处于不同的进程状态和界面情况，推送不同的事件类型，对应通知的显示方式会存在一定差异。推送通知主要的行为表现如下：

Event Type=1：

推送通知以系统通知的形式呈现，点击通知将跳转到发出通知对应设备的liveview界面。

Event Type=2000：

后台推送：推送通知以系统通知的形式呈现，此时滑动通知将关闭提示，点击通知将启动APP并出现呼叫接听界面。点击接听进入liveview，点击关掉进入设备列表；未对接cmd，进入设备列表并提示超时。
前台推送：iOS将直接出现呼叫接听界面等待30s（Android仍先以系统通知形式呈现，点击系统通知才出现呼叫接听界面），点击接听进入liveview，点击关掉进入设备列表；未对接cmd，进入设备列表并提示超时。如未进行任何操作，则呼叫接听界面消失。

> 注：系统通知的形式取决于手机系统设置的通知呈现方式，例如需要呈现横幅通知条，则需要在手机系统通知设置中选择以此方式呈现。

九、调试模式（Debug Mode）

Debug Mode为开发者和技术人员提供可排查问题之环境，进入设置界面选择开启调试模式，使用者可查看更多数据信息。Debug Mode可提供资讯内容如下：

9.1 设备状态返回值

在Debug Mode环境下，liveview界面可显示底层SDK返回的错误值，开发者和技术人员可根据错误返回值对比SDK文件介绍，了解目前导致设备非在线的状况，并采取相应措施。

9.2 实时画面数据

在Debug Mode环境下，实时画面上方会显示目前监控画面的资讯，内容说明如下:

十、FAQ问题

10.1 设备连线状态说明及应对措施

10.2 实时画面出图问题及原因

理想状态下，画面呈现的是设备监控到的，及时、流畅、清晰的实时影像。以下列出观看实时画面时使用者可能会遇到的状况以及原因，具体说明如下：

10.2.1 出图的速度

I帧的时间间隔：设备传送I帧的时间间隔影响APP开始进行解码的时间，通常在APP进入实时画面并向设备发送视频请求时，如果设备能够立即送出I帧，APP将更早进行图像处理。
网络环境：网络环境影响APP成功接收设备发送视频数据的时间，这将影响到APP何时可以开始进行解码并顺利出图。
APP解码效能：APP的解码效能越高,出图的速度越快。
手机性能：公版Kalay APP默认优先采用硬解方式进行解码，此时需要使用GPU资源。一旦硬解码失败，将自动切换至软解方式进行解码，此时需要占用CPU资源，所以手机性能的好坏将直接影响APP解码的效率。

10.2.2 清晰度

设备硬件：清晰度是人眼看到的宏观图像的清晰程度，视频的清晰度最根本上是受到视频采集设备的影响，所以镜头对光信号的捕捉和采集，以及摄像机内电耦合器件转化电信号的处理能力会影响设备获取到的图像的清晰程度。
设备编码效能：设备的编码效能与设备采用的视频编码芯片和编码算法有关，通常高效的编码算法能够在降低码流的同时保证图像的质量。
手机显示分辨率：在手机显示分辨率小于图像分辨率的情况下，要保证图像能够全屏显示，会丢失一小部分像素，这使得图像看起来较为模糊。

10.2.3 黑屏状态

黑屏状态造成的原因有因网络状况较差造成，设备视频数据未及时传过来,APP无视频数据可进行解码。也可能是因为设备传送的视频数据无法解析成功导致。如遇到黑屏状态，画面无法出图，建议从如下方面做确认：

确认当前APP与设备的连线是否仍正常（可配合log进行排查）；
确认当前APP与设备通道建立是否成功（可配合log进行排查）；
确认获取视频数据的指令交互是否成功（可配合log进行排查）；

若以上三步均正常，请至设置界面开启调试模式查看fps和bps的值，如果出现fps/bps=0的情况，可能因为视频数据无法解析成功导致解码失败，再进行如下确认：

设备实际视频编码的格式与I帧信息填入的格式一致；
设备传送的视频I帧信息中sps和pps填写正确。

10.2.4 花屏/灰屏

花屏/灰屏一般是因为有丢帧，通常可以从以下方面进行检查：

APP和设备端是否开启重传。
设备端avSendFrameData是否有报错。
APP端或者设备端是否有调用API进行clean buffer。

10.2.5 卡顿

卡顿通常因为网络较差造成，视频数据在不断重送到缓存buffer里，导致buffer塞满后数据被丢弃，APP无法从buffer里获取到数据进行解码，画面将出现卡顿现象。

10.3 监听/对讲噪音

监听噪声：监听是设备将采集到的声音传送给APP，故监听的噪声主要来源于设备采集的声音有噪音干扰。为消除监听噪音，设备应处理好噪音抑制。
对讲噪音：对讲噪音是手机端采集到的声音有噪音干扰，取决于手机本身处理噪音抑制的能力。

10.4 局域网下搜索不到设备

在添加设备进行本地搜索时，如果APP与设备已经处于同一局域网络下，尝试多次刷新后仍无法搜索到设备UID，主要原因及建议如下：

因SDK版本的兼容性问题导致，可以确认设备当前使用的SDK版本，如果低于SDK3.1.5.x以下建议做升级。
如设备端版本（3.1.10.1~3.1.10.6）在AP mode下会存在搜索不到UID的情况，建议尽快更新SDK版本。
确认APP端与设备端使用的局域网搜索端口对应一致。

10.5 常见提示/Error Message

10.6 事件播放异常状况及原因

10.7 部分安卓手机无法收到推送解决措施

10.7.1 小米手机

进入手机系统设置，点击“通知管理”，可以分别设置需要呈现的通知样式。在部分小米手机上，可以设定三种系统推送通知样式：锁屏通知、悬浮通知和桌面角标。

设定通知管理中的三种呈现样式，主要是为了设置整个手机系统通知的显示风格。在该页面开启了锁屏通知、悬浮通知和角标通知后，并不意味着某个应用也同步设定为该显示方式。您可能需要单独在某个应用中查看是否已经有同步开启相应的权限。如需要进一步去设定某个应用的推送通知呈现方式，请选择该应用进行单独设置。

点击下方的“Kalay”，进入该应用的通知设置页面。
如需开启推送通知，需要点击开启 “允许通知” 按钮，并建议您将“通知过滤规则”一栏设置为“全部设为重要”（主要是为了保证能够第一时间接收通知消息，而不会被其他消息覆盖）。
如图所示，建议您开启“桌面图标角标权限”、“悬浮通知权限” 和 “锁屏通知权限”这三个按钮的开关。

Kalay应用内嵌的推送通知功能，可再进一步设置更详细的通知方式。
如图所示，建议您开启“允许通知”后，再开启“悬浮通知权限”开关，这将允许应用在手机屏幕上方能够弹出推送通知消息。
“振动” 按钮开关可根据使用者需求而设定，“在锁定屏幕上” 通知的显示内容也可根据使用者的需求来设定。

10.7.2 华为手机

进入手机系统设置，点击“通知”，可以分别设置需要呈现的通知样式。在部分华为手机上，可以先设定系统推送通知样式：桌面图标角标、隐藏通知内容和状态栏显示通知图标。

设定通知与更多通知设置中的呈现样式，主要是为了设置整个手机系统通知的显示风格。在该页面中开启了桌面图标角标、状态栏显示通知图标后，并不意味着某个应用也同步设定为该显示方式。您可能需要单独在某个应用中查看是否已经有同步开启“允许通知”开关并勾选相应的提醒方式。如需要进一步去设定某个应用的推送通知呈现，请选择该应用进行单独设置。

点击下方的“Kalay”，进入该应用的通知管理页面。
如图所示，建议您开启“允许通知”开关后，点击“营销通知”再进行更详细的提醒方式设置。部分华为手机可设置两种提醒方式：锁屏通知和横幅通知。
“铃声”、“振动” 和“允许打扰” 功能可根据使用者需求来设定。

10.7.3 VIVO手机

进入手机系统设置，点击“状态栏与通知”，可以分别设置需要呈现的通知样式。在部分VIVO手机上，可以先设定系统推送通知样式：顶部预览样式和在锁屏显示。建议您将顶部预览样式勾选为：悬浮。

设定状态栏与通知中的呈现样式，主要是为了设置整个手机系统通知的显示风格。在该页面中开启了顶部预览和在锁屏显示后，并不意味着某个应用也同步设定为该显示方式。您可能需要单独在某个应用中查看是否已经有同步开启相应的权限。如需要进一步去设定某个应用的推送通知呈现，请选择该应用进行单独设置。

点击下方的“Kalay”，进入该应用的通知管理页面。
如图所示，建议您开启“允许通知” 开关后，同时开启“顶部预览”、“在锁屏显示” 按钮的开关。
“接受智能通知控制” 和“显示锁屏通知详情” 功能可根据使用者需求来设定。

10.7.4 OPPO手机

进入手机系统设置，点击“通知与状态栏”，可以分别设置需要呈现的通知样式。在部分OPPO手机上，可以先设定状态栏通知图标的样式：显示图标、显示数量和不显示。

点击“通知管理”，进入通知管理页面进行更多的系统通知设置。可再设定锁屏通知的样式：显示通知内容和不显示通知。

设定通知与状态栏以及通知管理中的呈现样式，主要是为了设置整个手机系统通知的显示风格。在该页面中设置状态栏通知图标和锁屏通知后，并不意味着某个应用也同步设定为该显示方式。您可能需要单独在某个应用中查看是否已经有同步开启相应的权限。如需要进一步去设定某个应用的推送通知呈现，请选择该应用进行单独设置。

点击下方的“Kalay”，进入该应用的通知管理页面。
如图所示，建议您开启“允许通知”开关后，同时根据使用需求来设定是否显示角标，以及是否开启“普通”、“系统默认通道”功能。

10.7.5 魅族手机

进入手机系统设置，点击“通知和状态栏”，可以分别设置需要呈现的通知样式。在部分魅族手机上，可以先设定系统推送通知样式：桌面通知和锁屏上显示通知。建议您均选择开启。

设定通知和状态栏中的呈现样式，主要是为了设置整个手机系统通知的显示风格。在该页面中开启了桌面通知和锁屏上显示通知后，并不意味着某个应用也同步设定为该显示方式。您可能需要单独在某个应用中查看是否已经有同步开启相应的权限。如需要进一步去设定某个应用的推送通知呈现，请选择该应用进行单独设置。

点击“通知智能管理”，选择“Kalay”，进入该应用的通知管理页面。
如图所示，建议您开启“允许通知” 开关后，同时再开启“优先”、“悬浮通知” 和“提醒” 按钮开关。（开启“优先” 主要是为了保证能够第一时间接收通知消息，而不会被其他消息覆盖）。

10.7.6 苹果手机

进入手机系统设置，点击“通知”，可以分别设置需要呈现的通知样式。在苹果手机上，可以先设定系统推送通知样式：显示预览。使用者可根据需要设置。

苹果手机的通知风格，需要针对某个应用单独设置。

点击下方的“Kalay”，进入该应用的通知管理页面。可以再改应用的推送通知样式：锁定屏幕、通知中心和横幅。建议您均选择开启。
“声音” 和“标记”，以及其他选项设置可根据使用者需求而设定。

10.8 OTA升级异常状况及原因

更多对接问题，可访问CDSN查看并留言：https://blog.csdn.net/TUTK_Team

[IO Command Definition]: https://www.showdoc.com.cn/tutkiocmd/8933974242642715 "IO Command Definition" [#架构及功能模块]: https://www.showdoc.com.cn/kalaypscnew/9566330354178598 "#架构及功能模块" [#API调用说明]: https://www.showdoc.com.cn/kalaypscnew/9566331228543334 "#API调用说明" [10.4]: #10.4 "第十章 FAQ问题10.4" [p6]: #p6 "第六章设备设置功能" [10.1]: #10.1 "第十章 FAQ问题10.1" [10.2]: #10.2 "第十章 FAQ问题10.2" [10.3]: #10.3 "第十章FAQ问题10.3" [10.5]: #10.5 "第十章 FAQ问题10.5" [10.8]: #10.8 "第十章 FAQ问题10.8" [10.6]: #10.6 "第十章 FAQ问题10.6" [10.7]: #10.7 "第十章 FAQ问题10.7" [p9]: #p9 "第九章调试模式"

Kalay1.0标准-升级版PSC