跳到主要内容

协议规格

蜂窝通信体验

描述联网应用遵循默认网络切换,比如WiFi切换到蜂窝网络,或者蜂窝切换到WiFi网络,或者蜂窝主卡切换到副卡网络,实现数据传输平滑迁移到默认网络上,避免网络切换后无法上网等问题;
类型规则
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明网络连接能力
描述联网应用,插SIM卡,不连接WIFI,应用可正常上网;
类型规则
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明数据传输能力
描述联网应用数传策略分层,包括但不限定于缓存、调速、请求大小资源等,遵循通信感知API(网络状态和通信建议)来调整数传策略;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明网络质量评估弱网感知判决
描述联网应用应通过通信感知API真实反馈引发用户体验异常的网络传输质量,包括但不限于服务器错误、无数据、丢包、乱序、抖动、高时延等信息;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明应用传输体验反馈

短距通信体验

描述- Host-based Card Emulation(HCE,基于主机的卡模拟)应用需要调用hasHceCapability()接口判断是否支持HCE功能; - HCE应用使用动态注册AID时,应用进入前台后,调用start(elementName: ElementName, aidList: string[])接口,注册为前台应用,应用退出前台后,调用stop(elementName: ElementName)接口取消注册前台应用;HCE应用使用静态注册AID时,应在应用的metadata中声明对应应用关注的AID; - HCE应用需要申请NFC卡模拟权限(ohos.permission.NFC_CARD_EMULATION),应声明HCE特定的action("ohos.nfc.cardemulation.action.HOST_APDU_SERVICE");
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明HCE卡模拟开发指南
描述应用应根据用户实际使用场景,严格按照API定义请求所需位置信息,具体而言: - 新闻资讯、网购、点餐类等对定位精度要求不高的应用在使用getCurrentLocation接口时,参数 SingleLocationRequest.locatingPriority应指定LocatingPriority.PRIORITY_LOCATING_SPEED; - 非导航、运动、出行类APP调用定位接口时,参数 ContinuousLocationRequest.locationScenario建议指定UserActivityScenario.DAILY_LIFE_SERVICE。 - 非导航、运动、出行类APP建议启动定位不超过10分钟,且不启动location类型的长时任务;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明获取设备的位置信息开发指导
描述添加围栏优先使用addGnssGeofence(fenceRequest: GnssGeofenceRequest): Promise<number>;接口,该接口限制了围栏触发后与用户的交互方式,只允许弹通知提醒;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明地理围栏开发指导
描述- 建议应用按需获取Wi-Fi扫描结果,避免频繁获取扫描结果;建议应用监听Wi-Fi扫描结果上报事件来获取Wi-Fi扫描结果,使用Wi-Fi扫描结果应满足用户隐私保护要求; - 应用需要合理使用添加建议网络配置接口(addCandidateConfig)、发起网络连接接口( connectToCandidateConfig)、删除网络配置接口(removeCandidateConfig),避免频繁的进行网络切换以及存储了大量网络配置信息,降低了Wi-Fi使用效率,建议网络配置使用完后及时删除; - 应用合理使用Wi-Fi连接状态和Wi-Fi网络状态查询,建议通过监听接口获取状态变化,避免频繁调用影响Wi-Fi业务体验;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明
描述联网类应用,在不插SIM卡的情况下,连接Wi-Fi后,应用可正常上网;
类型规则
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明
描述非运动健康类的应用不建议调用startBluetoothDiscovery,stopBluetoothDiscovery, setBluetoothScanMode接口;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明
描述应用不应该频繁连接和断开蓝牙设备,建议连接失败后重试间隔超过10s,失败重试次数<=3次;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明
描述应用合理使用BLE扫描参数,应遵循如下要求: - 建议使用BLE扫描过滤器参数,避免扫描不相关设备; - 建议使用SCAN_MODE_LOW_POWER或SCAN_MODE_BALANCED参数,减少SCAN_MODE_LOW_LATENCY(高占空比类型)的BLE扫描,减少蓝牙资源使用冲突影响用户体验;
类型建议
适用设备通用
应用形态适用性鸿蒙应用,鸿蒙元服务
说明广播与扫描开发指导