# APP功能介绍

一、关于Kalay APP

1.1 简介

Kalay APP是TUTK Kalay 平台的产品之一,是针对移动装置(智能手机/平板)所量身定制的APP,可兼容IPCamera和可视门铃设备类型。此APP具备完整的操作与设定功能,包含及时影像观看、语音对讲、设备SD卡录像回放、画质切换、设置摄像机功能等等,让使用者可随时随地在行动装置上及时观看与操作网络摄像机。

1.2 支援平台

iOS

  • 操作系统版本:iOS 10或更新版本
  • 可用于iPhone
  • 针对iOS 14进行最优化
  • 支援CPU架构:armv7、arm64、i386、x86_64

Android

  • 操作系统版本:Android 7.0 或更新版本
  • 可用于安卓手机
  • 针对Android 11进行最优化
  • 支援CPU架构:armeabi-v7a、arm64-v8a、x86、x86_64

1.3相关参数

  • 码流:
    根据当前网络的上传带宽、分辨率、帧率以及对画质的要求需设备端自行调整码流,RLY模式下建议:720P不超过1Mbps,480P不超过750kbps, 360P不超过500kbs。FPS在10~20fps之间,取中值15fps左右。
    P2P/LAN模式下,bps和fps可以往上调,以获得更好的画质和流畅度体验。

  • 分辨率:
    实际无最高分辨率限制,最佳效果支持2K(2560x1440)/20fps分辨率,亦可调至500W像素,实际效果将因手机和设备的性能有差异。

  • 支持的音视频格式:

类型 基础规格 补充说明
视频格式 MPEG4、H.263、H.264、MJPEG、HEVC、VP8、VP9 默认采用硬解码,失败后自动切换为软解;可通过API强制设定解码方式
音频格式 G711U、G711A、ADPCM、PCM、Speex、MP3、G726 支持8K/16K/22K/48K、8bit/16bit
  • 音频采样率:8K 采样精度:16bit (仅做参考)

1.4 支援语言(附语言表)

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

1.5 适配SDK版本号

SDK 3.4.4.x(可实现分区分流设定/支持Authkey/支持DTLS)

1.6 App版本号

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

1.7 更换Logo和App名称(附标准文件)

在TUTK公版 Kalay APP的基础上进行更换APP Logo和名称,可参照标准文件提供相应素材。(详见《Kalay APP更换Logo标准文件_20210720.pdf》)

1.8 App操作流程概述

参考以下流程图:

二、功能对接

2.1 标准功能

采用Kalay APP的公版设计,即拥有以下软件功能:

  • 多国语系支援:英文、繁体中文、简体中文
  • 账号注册(手机号/邮箱)
  • 账号登录
  • 重置账号密码
  • 查看账号信息
  • 新增设备
  • AP直连配置
  • AP模式添加
  • 扫描QR Code
  • 本地搜索
  • 移除设备
  • 实时影像
  • 对讲/监听
  • 双向语音(仅门铃)
  • 本地录像
  • 画质切换(QVGA按钮)
  • 镜像/翻转
  • 云台控制
  • 设备设定
  • SD卡录像及回放
  • 查看手机相册
  • 设备信息
  • SD卡信息
  • 调试模式
  • 极光/厂商平台推送/Google/苹果推送
  • 云存储录像及回放
  • 方案管理

2.2 选配功能

设备(硬件)需要对接Kalay APP所规范的对应IO Command,且硬件具备该功能,才能执行以下功能。

  • 云台预置位设定:给设备监控镜头设定,或使设备转动到预设的监控位置。
  • 云台自动巡航:让设备云台按照预先设定的轨迹/转速进行转动。
  • 影像明暗:设置APP监控画面显示的明暗度。
  • 影像对比:设置APP监控画面显示的对比度。
  • 低功耗唤醒:针对低功耗门铃或IP Camera设备提供唤醒功能。
  • 回放进度控制:事件回放时控制播放进度,此功能需对接相应的cmd。
  • 语音识别:识别语音后对设备进行云台控制操作。
  • OTA升级:通过OTA远程升级,更新设备固件版本。

2.3 功能对接(附IO Command文档)

设备需要依据TUTK提供的IO Command文档进行功能对接。(详见#Command及说明 https://www.showdoc.com.cn/kalayvsaasappforpublic/7752265589889659 )。

注:为规范公版Kalay APP IO Command的设定和使用,禁止随意更改公版IO Command已制定的参数和结构体,如因随意更改造成设备无法成功对接公版APP,TUTK无需承担任何责任。同时,为满足客制化项目的需求,将预留部分参数区段以供客制化Command的设定。

2.4 Partial Source Code(附说明文档)

Partial Source Code及相关文件均属TUTK所有,通常不对外开放,如已购买TUTK公版Kalay APP 部分源代码,将会附上相关说明文档以供参考。

三、帐号登录/注册

帐号管理部分包括:帐号的注册、登录、重置密码和帐号设置等功能。
开启APP时会显示欢迎画面,若使用者有登入过APP且未执行登出将直接进入设备列表页面,否则将会进入登录界面。

3.1 帐号注册

在正常使用此应用前,首先需要先注册帐号。点击登录界面上的“注册”字样进入注册帐号页面,Kalay可支持邮箱注册和手机号注册两种方式。

  • 使用者输入正确的邮箱地址或手机号码、密码、确认密码和昵称,点击“发送验证码”后,服务器将发送激活验证码至该邮箱或手机号码下,验证码时效为60s。
  • 使用者需至邮箱或手机短信查收验证码并输入后提交。
  • 成功建立帐号。

注:

  • 帐号输入栏位为空时,点击“注册”按钮,输入栏下方将会提示:“请输入您的帐号”。
  • 密码输入栏位为空时,点击“注册”按钮,输入栏下方将会提示:“请输入您的密码”。
  • 确认密码输入栏位为空时,点击“注册”按钮,输入栏下方将会提示:“请再次输入您的密码”。
  • 名字输入栏位为空时,点击“注册”按钮,输入栏下方将会提示:“请输入您的名字”。
  • 如果检测到输入的手机号码和邮箱不是正确的,将提示:“此为无效帐号”。
  • 如果输入的密码不符合规则,将提示:“请使用8-20个字符来建立密码,至少需要包含1个大写字母,1个小写字母与1个数字”。
  • 如果确认密码与密码不一致,将提示:“密码与确认密码不一致”。
  • 如果输入的验证码不正确,APP将提示:“验证码错误,请重新输入”。
  • 如果输入的帐号已经注册过,将弹出提示:“该用户已存在”。

3.2 帐号登录

帐号登录主要采用密码登录的方式。

使用者选择密码登录的方式时,输入帐号与密码后点击“登录”;登录界面自动识别输入的帐号是电子邮箱或者手机号,并进行如下检测:

  • 帐号输入栏位是否为空,如果输入栏位为空,则提示:“请输入您的帐号”。
  • 密码输入栏位是否为空,如果输入栏位为空,则提示:“请输入您的密码”。
  • 帐号或密码是否正确,如果不正确,则提示:“帐号或密码错误”。
  • 该帐号是否存在或成功激活?如果该帐号未建立,则提示:“帐号或密码错误”。

确认使用者输入的帐号和密码均正确后,成功登录帐号将进入APP主界面,此时使用者可以执行后续操作。
在登录过程中,出现网页错误提示,使用者可能需要确认网络是否异常,或根据错误提示确认原因。

3.3 忘记密码

帐号登录过程中,使用者如果忘记正确密码,可进行密码重置。点击“忘记密码”将进找回密码界面,如下图所示。

  • 输入正确的手机号码或者邮箱;
  • 点击“获取验证码”并填入查收的验证码;
  • 输入符合规则的新密码和确认密码后,点击“提交”;
  • 重置帐号密码成功,返回登录界面。

注:

  • 帐号输入栏位为空时,点击“提交”按钮,输入栏下方将会提示:“请输入您的帐号”。
  • 新密码输入栏位为空时,点击“提交”按钮,输入栏下方将会提示:“请输入您的密码”。
  • 确认密码输入栏位为空时,点击“提交”按钮,输入栏下方将会提示:“请再次输入您的密码”。
  • 名字输入栏位为空时,点击“提交”按钮,输入栏下方将会提示:“请输入您的名字”。
  • 如果检测到输入的手机号码和邮箱不是正确的,点击“提交”按钮,将提示:“此为无效帐号”。
  • 如果输入的密码不符合规则,点击“提交”按钮,将提示:“请使用8-20个字符来建立密码,至少需要包含1个大写字母,1个小写字母与1个数字”。
  • 如果确认密码与密码不一致,点击“提交”按钮,将提示:“密码与确认密码不一致”。
  • 如果输入的验证码不正确,点击“提交”按钮,将提示:“验证码错误,请重新输入”。
  • 输入的手机号码不正确,点击“发送验证码”按钮,则提示:“短信发送失败”。
  • 输入的帐号不正确,点击“发送验证码”按钮,则提示:“此为无效帐号”。

3.4 查看帐号信息

点击侧边栏上方昵称旁的设置按钮,进入“我的帐号”界面,界面显示该帐号的信息,名字等资讯,使用者可对帐号名字和密码进行修改,还可进行帐号登出。

四、主界面

在主界面上,可查看本地设备列表,还可点击进入侧边栏、手机相册和查看云服务。本地设备列表是已被添加设备的清单,设备按照被添加的时间先后顺序从上往下排列。设备列表截图上主要显示:设备名称和设备类型。

注:在主界面设备列表处,长按单个设备可进行快速删除设备操作。

4.1设备列表截图及刷新

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

4.2设备名称

名称有限定为12位。在Liveview界面点击导航栏可修改相应设备名称。

4.3设备类型

根据添加设备时选择的类型,在设备列表截图右下角会显示相应类型的图标。目前Kalay APP可添加的设备类型有两种:IP Camera、Doorphone。

4.4侧边栏

点击主界面左上角的菜单按钮,进入侧边栏界面,此界面可以进行如下操作:

  • 查看帐号资讯
  • 查看云存储内容
  • 进入关于界面,查看APP当前的版本号和SDK版本号等资讯。
  • 查看APP免责条款内容
  • 查看隐私政策说明

五、新增设备

新增设备可透过点击首页下方的“+”号,然后选择对应的设备类型和添加方式进行新增。
新增设备流程如下:

5.1 选择设备类型

目前可支持的设备类型有:网络摄像头(IPCamera)和可视门铃(Doorphone)。

5.2 选择添加方式

5.2.1 新增未连接路由器设备

5.2.1.1 AP模式添加

  • 点击“+”号,在弹出选项中,选择:Not been connected to the router;
  • 去系统WIFI设置连接上设备的AP热点后,返回APP;
  • 点击“下一步”,APP将进行如下判断:
      a.手机当前连接Wifi是否可出外网:是—>提示“未成功切换至设备wifi”;否—>开始自动搜索设备UID;
      b.搜索设备UID是否成功:是,且只有1UID—>成功跳转添加设备界面;是,但大于1UID—>提示:“未成功切换至设备wifi”;否—>提示:“无法找到该设备,请重试”。
    
  • 输入设备密码(或者Token);
  • 如设备采用authkey,需再开启authkey开关后输入正确的authkey,APP与设备建立连接;
  • 弹出是否需要给设备配置网络的对话框,并执行如下行为:
      a.否:APP请求添加设备至服务器成功并返回设备列表,结束此流程。
      b.是:进入配置网络页面,APP获取设备周边可配置的网络;
    
  • 用户选择设备要添加的网络并输入网络密码,APP发送WiFi/SSID及密码给设备;
  • 等待设备配置到选定的WiFi,APP与设备建立连线成功;
  • APP请求添加设备至服务器并返回设备列表。

5.2.2 新增已连接路由器设备

  • 点击“+”号,在弹出选项中,选择:Been connected to the router;
  • 默认进入本地搜索界面

5.2.2.1 本地搜索

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

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

(出现在局域网下搜索不到设备的现象,可参考第十二章 FAQ问题12.4)

5.2.2.2 二维码扫描

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

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

5.2.2.3 手动输入

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

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

5.2.3 新增设备限制

  • 此APP可添加设备数量上限默认为16台,同一个UID不能重复添加。如APP已添加16台设备后,点击“+”时会弹出相应提示:设备已满无法再新增设备,请删除部分设备再试。
  • 同一台设备仅能添加至一个帐号下。如果添加设备时检测到此设备已被其他账号绑定,将提示:“该设备已被其他账号添加,请重试。”
  • 同一个账号下的所有设备,名称不能相同。如果添加设备时填入的设备名称与该账号下的其他设备名称相同,将提示:“该设备已存在。”

六、设备画面预览

在本地设备列表点选要查看的IP Camera/门铃设备,APP将跳转到Liveview界面并开始与设备进行连线。

6.1设备连线状态及刷新

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

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

(详细的状态说明以及应对措施,可参考第十二章 FAQ问题12.1)

6.2密码检测机制

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

密码检测和设定规则:

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

6.3设备唤醒功能

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

6.4观看实时影像

在Liveview界面,点击画面上的三角播放按钮,方可观看设备的实时影像。点击画面右下方横屏按钮,可进行监控画面横屏切换。IOS可通过上方导航栏返回键切回竖屏状态,Android可通过手机虚拟返回键切回竖屏状态。两指操作可对实时画面进行缩放。
在Liveview界面点击导航栏可修改相应设备名称。

注:实时画面持续播放的时长建议不超过30min,如用户持续观看实时画面30min后,APP将会弹出相应提示:您已观看实时画面30min,是否需要继续观看?

(影响实时画面出图及原因,可参考第十二章 FAQ问题12.2)

6.4.1对讲及监听

打开喇叭,监听设备周围的声音;打开麦克风,可与设备端沟通。

  • 当此设备类型为IPCamera时,对讲/监听采用半双工处理,即监听和对讲只能二选一,不能同时使用。
  • 当此设备类型为Doorphone时,对讲/监听采用全双工,即监听和对讲同时开启,并做手机端消回音处理。
  • APP支援的音频格式参考第一章。

(监听和对讲出现噪音的原因,详见第十二章FAQ问题12.3)

6.4.2拍照及录像

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

6.4.3镜像及翻转

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

6.4.4分辨率/QVGA

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

6.4.5云台控制/PTZ

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

  • 通过手势在画面区域上滑动上下左右方向来控制设备进行云台转动。
  • 通过点击画面区域左下角PTZ按钮,切换出方向控制面板来控制设备进行云台转动。方向控制面板可实现”单击”和”长按”两种操作:单击某个方向键可向设备发送一次转向请求;长按某个方向键可向设备每隔1s持续发送转向请求。
  • 通过长按“对讲”按钮,出现语音识别界面来控制设备进行云台转动。(详细操作参见6.4.6语音识别)

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

6.4.6语音识别

APP对接的语音识别功能主要用于控制设备进行云台转动。识别关键字初步定义为“上”“下”“左”“右”四个方向,并根据识别到的关键字内容发送相应指令给设备,实现PTZ控制。
语音识别基本操作:

  • 长按“对讲”按钮,出现语音识别界面。
  • 点击下方“关闭”按钮,退出语音识别界面。

七、设备设置

IP Camera/门铃设备从Liveview界面,点击导航栏右边的设置按钮,可进入设备设置界面。当设备处于非online状态,设置按钮将无法点击。

(设置界面常见提示/Error Message说明,可参考第十二章 FAQ问题12.5)

7.1 修改设备密码/Change Password

修改设备密码仍需符合密码规则:

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

功能可用前提:设备与APP连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

7.2 设置网络/WiFi Setting

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

7.3 远端录像设定/Recording Mode

设定设备录像模式:关闭/全时录像/移动侦测录像
功能可用前提:设备与APP连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

7.4 移动侦测设置/Event settings

设定是否开启设备侦测功能,开启后可设定侦测的灵敏度高低。
灵敏度设置选项有:低/中/高/最高四种。
功能可用前提:设备与APP连接状态为在线、设备支援此功能、设备成功对接此功能的IO Command。

7.5 调试模式/Debug Mode

开启调试模式开关,在Liveview画面上方将显示的调试信息。

(调试模式说明,可参考第十一章 调试模式)

7.6 同步时间/Sync Time

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

7.7 SD卡信息/格式化

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

7.8 设备信息/OTA

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

功能可用前提:

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

(OTA升级出现异常提示/Error Message说明,可参考第十二章 FAQ问题12.8)

7.9 呼叫声音类型设定(For Doorphone)

功能可用前提:添加设备时,选择的设备类型为门铃。
功能作用:设定APP收到推送消息时,手机端发出的通知声音类型。

7.10 删除设备

将设备从APP移除,执行此操作后,手机将不能再收到该设备的推送消息。
删除设备有两种方式:

  • 在设备列表,长按设备截图进行删除。
  • 在设置界面,选择删除设备/Remove this device进行删除。

八、SD卡事件

事件列表及回放主要是获取并播放设备存储在SD卡的录像。可点击Liveview界面左下角按钮进入事件列表,如APP从设备端未获取到任何事件,则APP提示:“未找到任何记录”。当设备处于离线(Offline)状态时,APP会提示:“离线”。

8.1 搜索事件列表

  • 录制事件的时间会以设备当前时间为基准。APP默认搜索手机系统当前时区24小时内的录像。
  • 搜索指定时间段:点击Event界面右上角的搜索按钮,选择需要的时间段进行搜索。
  • SDCard录像可按照全部、移动侦测和全时类型三种类型筛选,通过切换标签查看不同类型下的事件列表。

8.2 SD卡事件回放

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

(在进行事件播放时,也可能会出现多种异常状况,异常状况的说明以及原因可参考第十二章 FAQ问题12.6)

8.3 播放控制

播放单个事件时,可以进行如下控制:

  • 全屏播放
  • 暂停播放
  • 重新播放
  • 拖动时间进度(仅限已对接了IO Command的设备)

九、云存储

点击侧边栏的“云存储”进入方案管理界面,使用者可以查看当前帐号已经购买的计划方案列表。方案列表显示方案的类型,有效期,已绑定的设备和方案计划当前的状态。

9.1 购买方案

进到我的云存储界面后,如果此帐号尚未购买方案,则会显示 “暂未购买云方案,立即购买吧~”。使用者点击“立即购买”后在APP内进入购买流程。

  • Android CN版本可支持支付宝支付和微信支付,Android US版本可支持Google Pay;iOS仅支持Apple Pay。
  • 每个帐号可以支持购买多个相同/不同类型的方案,但每个方案仅可绑定最多1台设备。
  • 购买云存储方案前,需确认该账号下的设备已开通云存储功能,否则可能无法执行后续的支付操作。

9.2 查看方案信息

在我的云存储页面,左右滑动页面可以查看已经购买的所有方案。

  • 点击“订单详情”,可查看相应已购买方案的详细服务内容,包括服务时间、服务名称、服务内容、订单号、购买时间、方案价格和支付方式的信息。
  • 已绑定了设备的方案,仍可通过点击“绑定设置”切换至其他设备进行绑定。

9.2.1 方案的类型

Kalay目前支持7天循环录像和30天循环录像两种方案类型,详细的云存储方案套餐如下:

  • 7天循环录像单月套餐
  • 7天循环录像年套餐
  • 30天循环录像单月套餐
  • 30天循环录像年套餐

9.2.2 套餐服务时间

套餐服务器时间段以购买套餐时间起算,有效期与购买的方案类型一致。
如:使用者购买了一个7天循环录像单月套餐,则有效期为一个月,在一个月内可以进行7天循环录影。如果使用者再次购买一个7天循环录像单月套餐,则生成一个新的方案,套餐服务时间有效期为一个月,在一个月内可以进行7天循环录影。30天循环录像同理。

在套餐服务时间内,设备可以正常推流至服务器,使用者可在云端界面中查看云端事件。

9.2.3 方案的状态

方案列表显示的方案状态只有启用状态一种。启用状态下使用者可以更换设备进行绑定。而已过期的方案将不会显示。

9.2.4 绑定设置

正在启用的方案,每个方案计划可以绑定1台设备,同时一台设备只能绑定在一个方案计划下。

  • 在绑定设备一栏中,点击“设置”进入云存储设置页面;
  • 勾选需要绑定的设备,并点击“确定”;
  • 绑定设备成功,返回方案列表。

已绑定设备的方案计划将显示该设备对应的设备名称,使用者可以进行切换绑定设备或者解绑设备。解绑设备后,如果方案仍处于7天或30天可上传云端录像有效期内,则新绑定的设备仍可继续上传云端录像。

注:部分不支持云存储的设备,在云存储设置页面会显示“该设备不支持云存储”,此类设备无法绑定至方案下,如使用者需要为此类设备开通云服务,建议咨询相应的设备厂商请求对接此功能。
而已绑定云存储的设备,在该页面会显示“该设备已绑定方案”,此类设备无法直接绑定至新的方案下,如使用者需要修改已绑定设备的云存储方案类型,建议先将已绑定设备解绑后再进行绑定。

9.3 查看云端事件

在主界面点击右下角“云端”按钮,进入页面查看云端事件。云端事件列表默认显示当日所有存储在云端的事件、设备的名称、事件类型、时间和缩略图。

如果此账号尚未购买方案,则页面会显示 “暂未购买云方案,立即购买吧~”,使用者需要购买方案才能正常观看云端事件。
如果此页面显示“云方案已到期”,则表示设备已绑定的方案已过服务时间,需要重新购买方案才能正常观看云端事件。

点击单个云端事件可查看画面内容,并进行如下操作:

  • 左右滑动时间轴可以刷新列表,并自动跳转至对应时间点的事件进行播放,当前播放的事件下方会显示“正在播放”;
  • 时间轴从起始至结束涵盖24小时,有事件的时间点会显示为橙色,无事件显示为白色;
  • 开始播放单个云端事件后,会自动连续播放下一个事件,直至当日时间结束;
  • 点击“全屏”按钮,切换至全屏播放状态;
  • 点击“静音”按钮,开启或者关闭事件播放的声音;
  • 点击“截图”按钮,保存一帧图片至手机系统相册;
  • 点击“下载”按钮,下载云端事件至手机系统相册;
  • 点击“倍速播放”按钮,切换云端事件播放的速度,目前可支持1x/2x;
  • 点击“删除”按钮,将事件从云端删除;
  • 点击右上角“关闭”按钮,停止播放云端事件并关闭播放画面;
  • 点击左上角“云端”按钮,跳转到我的云存储界面,可查看当前设备启用的方案信息;
  • 点击右上角“日历”按钮,弹出日历控件,可选择需要查看的事件的日期(仅支持单选)。

(云存储服务开通或观看遇到的常见问题,可参考第十二章 FAQ问题12.9)

十、消息推送

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

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

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

10.1消息推送设定

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

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

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

10.2 消息推送类型

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

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

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

10.3 查看推送通知

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

非门铃设备类型:(Event Type=1和2000)

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

门铃设备类型:(Event Type=1)

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

门铃设备类型:(Event Type=2000)

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

在设备开启移动侦测及报警推送,且设备被事件触发,发送通知至KPNS Server,由KPNS推送至第三方推送平台(APNS/FCM/信极光/华为/小米/VIVO/OPPO/魅族),再由第三方将讯息推送到用户的手机上。

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

十一、调试模式

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

11.1设备状态返回值

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

11.2 实时画面数据

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

十二、FAQ问题

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

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

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

12.2.1出图的速度

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

12.2.2清晰度

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

12.2.3黑屏状态

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

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

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

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

12.2.4花屏/灰屏

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

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

12.2.5卡顿

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

12.3 监听/对讲噪音

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

12.4 局域网下搜索不到设备

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

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

12.5 常见提示/Error Message

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

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

小米手机

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

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

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

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

华为手机

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

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

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

VIVO手机

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

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

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

OPPO手机

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

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

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

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

魅族手机

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

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

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

苹果手机

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

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

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

12.8 OTA升级异常状况及原因

12.9 云存储常见问题

12.9.1 云存储功能介绍

开通云存储功能后,摄像头侦测到的移动视频会加密上传至云端,设备掉线也能回看录像。有效避免人为破坏、SD卡损坏造成的关键视频丢失。上传到云端的视频也可下载到手机本地。

12.9.2 存储到云端的视频是否安全?

上传到云端的视频会经过多层加密,针对请求播放云端视频的用户,也有多重身份认证机制,可以有效阻止未经授权的连接,并且可避免对设备的攻击,您可以放心使用。

12.9.3 购买云存储服务后,服务时间如何计算?

当您购买成功后,云存储服务正式生效开始使用。我们会以从购买成功的时间点开始计算服务终止时间。比如:您2020年8月1号8点购买一年的30天滚动云存储服务,我们会从2020年8月1号8点开始计时,则服务终止时间为:2021年8月1号8点。

12.9.4 云存储服务如何续费及时间计算?

任何时候都可在我的云存储->选择云存储有效期后的“再次购买”进行续费,若服务未结束,则直接在原有时间上延长服务时间。比如服务到期时间为:2020年5月1日8点,用户在2020年5月1日8点延长一个月,则延长后的时间期限为2020年6月1日8点;若服务已结束,则需要重新计算时间。比如服务到期时间为2020年5月1日8点,在5月1日9点进行续费,则云存到期时间为2020年6月1日9点。

12.9.5 云存储服务是否能中途退费、更换付费方案?

云存储服务不支持中退费及更换付费方案。比如:您正在使用为期一年的30天滚动云存储服务,中途不支持退费和更换成其他付费方案。需在当前使用服务结束后,再进行更换。

12.9.6 什么是滚动循环录制?

滚动循环录制是指比如您购买了7天滚动循环录制,第8天的视频会将第一天的云端视频覆盖掉,以此类推。目前提供7天、30天两种滚动循环录制方案可供选择。

12.9.7 云存储服务到期后视频是否能查看?

服务到期后,将停止再上传新视频到云端。已经保存在云端的视频将按照滚动循环录制的天数进行滚动删除,在删除之前的视频都可查看。比如您购买了7天滚动循环录制,服务到期,将在到期后的第二天删除第一天的视频,以此类推。

12.9.8 云存储服务使用过程中是否能暂停?

不可以暂停,使用过程中可关闭云存储上传,但服务时间不延长。关闭后视频将不再上传。

12.9.9 是否支持下载云端视频?

支持下载。您可在观看云存储页面点击“下载”选择需要下载的云端视频。

12.9.10 如果机器解绑,被别人绑定后,是否能看到云端视频?

云存储服务将设备和账号绑定,拥有云存储服务的设备绑定至新账号时,将无法继续享受服务。如A用户购买云存储服务后将机器解绑,B用户再绑定该设备后,B用户将无法查看到A用户在云端的视频。B用户如需使用,需重新购买。A用户在解绑后仍可通过“事件界面——已解绑设备”查看存在云端的视频。

12.9.11 云储存怎么不上传?

  • 确认设备是否有绑定云存储方案(进入账号界面——点击付费方案界面——查看方案内容上已绑定设备,如提示“未绑定设备”,点击“去绑定”)
  • 检查设备云储存上传开关是否有打开(进入摄像机设置界面——点击“我的云储存”——打开“视频上传服务开关”后面的开关按钮)
  • 确认用户能否通过手机进行实时监控,确认下网络状况
  • 建议用户尝试重启摄像机
  • 向用户收集云储存订单,设备编号,内存卡中的log文件提交技术群进行分析

12.9.12 我是苹果手机用户能购买两个自动续费套餐吗?

不可以的,由于苹果技术原因只能存在一个自动续费订单,订阅自动续费后订单会变为单次购买的形式。

12.9.13 开通了云储存显示扣款成功了,但是app里面没有显示开通成功?  

请用户收集付款的信息、摄像机序列号提供给购买设备时的客服进行核实。

12.9.14 在云存储方案里面,为什么选择绑定设备时,找不到我的设备?

只有支持云存储功能的设备才能绑定到云存储方案下,如找不到,表示添加的设备不支持云存储功能。

12.9.15 怎样取消连续包月?

终止方法: 请手动打开苹果手机“设置”——>进入“iTunesStore与AppStore”——>点击“AppleID”,选择查看“查看AppleID”,进入“账户设置”页面,点击“订阅”,选择慧家看看自动续费云存储服务取消订阅即可。如未在订阅期结束的至少24小时前关闭订阅,此订阅将会自动续订。在下个周期结束后,则不再自动续费扣款。


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