# 协议规格

## 蜂窝通信体验

|-----------|------------------------------------------------------------------------------------------------------|
|**描述**|联网应用遵循默认网络切换，比如WiFi切换到蜂窝网络，或者蜂窝切换到WiFi网络，或者蜂窝主卡切换到副卡网络，实现数据传输平滑迁移到默认网络上，避免网络切换后无法上网等问题;|
|**类型**|规则|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[网络连接能力](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/network-kit-network-management)|

|-----------|-----------------------------------------------------------------------------------------------------|
|**描述**|联网应用，插SIM卡，不连接WIFI，应用可正常上网；|
|**类型**|规则|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[数据传输能力](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/network-kit-data-transmission)|

|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|联网应用数传策略分层，包括但不限定于缓存、调速、请求大小资源等，遵循通信感知API(网络状态和通信建议)来调整数传策略；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[网络质量评估](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/networkboost-qoscallback)、[弱网感知判决](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/networkboost-qoscallback)|

|-----------|---------------------------------------------------------------------------------------------------|
|**描述**|联网应用应通过通信感知API真实反馈引发用户体验异常的网络传输质量，包括但不限于服务器错误、无数据、丢包、乱序、抖动、高时延等信息；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[应用传输体验反馈](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/networkboost-appreportqoe)|

## 短距通信体验

|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|* 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"）；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[HCE卡模拟开发指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/nfc-hce-guide)|

|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|应用应根据用户实际使用场景，严格按照API定义请求所需位置信息，具体而言： * 新闻资讯、网购、点餐类等对定位精度要求不高的应用在使用getCurrentLocation接口时，参数 SingleLocationRequest.locatingPriority应指定LocatingPriority.PRIORITY_LOCATING_SPEED； * 非导航、运动、出行类APP调用定位接口时，参数 ContinuousLocationRequest.locationScenario建议指定UserActivityScenario.DAILY_LIFE_SERVICE。 * 非导航、运动、出行类APP建议启动定位不超过10分钟，且不启动location类型的长时任务；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[获取设备的位置信息开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/location-guidelines)|

|-----------|------------------------------------------------------------------------------------------------------------|
|**描述**|添加围栏优先使用addGnssGeofence(fenceRequest: GnssGeofenceRequest): Promise<number>;接口，该接口限制了围栏触发后与用户的交互方式，只允许弹通知提醒；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[地理围栏开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/geofence-guidelines)|

|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|* 建议应用按需获取Wi-Fi扫描结果，避免频繁获取扫描结果；建议应用监听Wi-Fi扫描结果上报事件来获取Wi-Fi扫描结果，使用Wi-Fi扫描结果应满足用户隐私保护要求； * 应用需要合理使用添加建议网络配置接口（addCandidateConfig）、发起网络连接接口（ connectToCandidateConfig）、删除网络配置接口（removeCandidateConfig），避免频繁的进行网络切换以及存储了大量网络配置信息，降低了Wi-Fi使用效率，建议网络配置使用完后及时删除； * 应用合理使用Wi-Fi连接状态和Wi-Fi网络状态查询，建议通过监听接口获取状态变化，避免频繁调用影响Wi-Fi业务体验；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|无|

|-----------|-----------------------------------|
|**描述**|联网类应用，在不插SIM卡的情况下，连接Wi-Fi后，应用可正常上网；|
|**类型**|规则|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|无|

|-----------|-------------------------------------------------------------------------------------|
|**描述**|非运动健康类的应用不建议调用startBluetoothDiscovery，stopBluetoothDiscovery， setBluetoothScanMode接口；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|无|

|-----------|---------------------------------------------|
|**描述**|应用不应该频繁连接和断开蓝牙设备，建议连接失败后重试间隔超过10s，失败重试次数<=3次；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|无|

|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------|
|**描述**|应用合理使用BLE扫描参数，应遵循如下要求： * 建议使用BLE扫描过滤器参数，避免扫描不相关设备； * 建议使用SCAN_MODE_LOW_POWER或SCAN_MODE_BALANCED参数，减少SCAN_MODE_LOW_LATENCY（高占空比类型）的BLE扫描，减少蓝牙资源使用冲突影响用户体验；|
|**类型**|建议|
|**适用设备**|手机，平板，PC/2in1，智慧屏，车机，智能穿戴，轻量级智能穿戴|
|**应用形态适用性**|鸿蒙应用，鸿蒙元服务|
|**说明**|[广播与扫描开发指导](https://developer.huawei.com/consumer/cn/doc/atomic-guides/atomic-bluetooth-advertising)|