HarmonyOS SDK闭源开放能力技术团队

请参考示例代码：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V13/account-phone-unionid-login-V13#section44701937172920。华为知道链接：https://3ms.huawei.com/hi/newask/?1、华为账户从来没有绑定过开发者应用， 这个时候 因为这个用户的唯一标识未在开发者应用的数据库中， 所以必须要通过华为账户一键登录界面（单独界面） 登录；

LoginWithHuaweiIDButtonParams 中的有个supportDarkMode属性，设置为true后，需要自行响应系统的变化，见文档：https://developer.huawei.com/consumer/cn/doc/atomic-references/account-api-atomic-component-manager-0000001735382454#section4717249182518。onClickEvent：注册的是“华为账号登录按钮的点击事件”，也可能有错误。

通过Push Kit更新实况窗内容的过程是自动更新的。但首先需要符合实况窗设计规范，参考链接：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/liveview-design-formula-V5。通过Push Kit创建实况窗之后，再更新实况窗失败，平台查询提示“实况窗端更新失败，通知未创建或已经过期”。此外，实况窗白名单设备管理（可选）仅用于调试或体验，如已开通实况窗权限则不需要加白名单应用也可用实况窗功能。

或者在工程中用 fs.access 判断一下文件是否存在https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-file-fs-V5#fsaccess。升级到Beta5版本，身份证拍摄页面，调用卡证识别控件，身份证正面拍摄可以获取到照片，国徽面获取不到照片，Beta2版本正常，报13900002 No such file or directory 错误。如身份证为人像面和国徽面，护照为单面。

分享服务的分享方式区中的应用不能控制，但是可以控制目标应用置顶，让目标应用展示靠前，demo供参考：https://gitee.com/harmonyos_samples/share-kit_-sample-code_-clientdemo_-arkts#%E7%AE%80%E4%BB%8B。华为分享里面的设备不会全部展示出来，另外如果开启了10分钟所有人可见华为分享，超过10分钟会自动回退到仅分享过的设备可见，如果这10分钟之内，设备有被分享过，则对端是依然能看到这个设备的，属于非问题。

1、当前提供了应用内打开PDF的组件，可以使用：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/pdf-pdfview-open-V5。pdfservice应该是不支持加载网络PDF的，可以把文件下载到沙箱目录加载，或者使用Web组件，Web组件可以加载网络的PDF文件。预览PDF文件，文档上所描述的loadDocument接口，可以返回文件的状态，并无法实现PDF的预览，是否有能预览PDF相关接口？

配置的client_id位置信息，请查看“配置Client ID”指南：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/health-configuration-client-id-V5。路径见“配置Client ID指南”：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/health-configuration-client-id-V5。

开发者可以发送邮件至jointoperation@huawei.com（先前双框架联运应用退款专用邮箱），包含华为订单号，应用名称/课程名，退款金额 退款原因等信息。针对(1)，用户可以拨打华为客服热线咨询退款. 华为业务运营会联系到开发者然后由开发者决定是否给用户退款，以及退款具体金额，部分退款还是全额退款（针对订阅型商品使用部分权益可能会涉及到部分退款）应用和元服务都接入了IAP能力，用户在元服务里面支付购买了会员，然后他又下载了应用，如何做到在应用里面也是会员，无需重复购买？

0.0.65 和 0.0.66 的系统，一键登录这块是不是有bug或者是否做了需要应用侧做更新的变更，三台设备，都是应用市场的包，两台获取不到匿名手机号，之前都是可以获取到的，两台获取不到的其中一台，刚才卸载后重新安装又可以获取到了，报的错是 code:1001500001;5、在AGC上面，添加公钥指纹 (HarmonyOS API 9及以上)后，指纹有一定时间的缓存，不会立刻生效，建议配置完成后等半小时再尝试。PC场景，青少年模式系统API不支持，另外文档上的几个API也不支持。

是否在关闭通知权限期间有向设备推送消息，关闭通知权限期间推送消息后设备会被管控，被管控后发送的消息不会送达设备，再次打开通知权限后会上报解除管控，为防止用户频繁开关导致频繁上报解除管控，目前规格会延迟1min上报，待解除管控后即可收到消息无需重新生成token。通过服务端排查，发现推送的消息都是营销通知，营销消息不是每条消息都直接下发，会等一批一起下发，属于华为推送服务端降低功耗的一种消息机制。若开发者的应用进程在前台，则不弹出通知提醒，开发者可以在应用进程中获取通知扩展消息内容并自行完成业务处理。

响应码为80100016，是指消息内容校验未通过，检查下对应字段是否含敏感词，对于各业务响应码的介绍可参考文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/push-scenariozed-api-response-V5#section9211164014816。uri属于应用内置页面ability对应的uri，而百度链接属于外部链接，没办法跳转的。因为是新应用了，需要的权限都要走流程申请。

2、“EntryAbility”下actions和uris值是否已设置：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-send-alert-V5#section8794131614597。2）目标应用中不存在指向的页面 参考：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-msg-receipt-V5。

可以添加多个Marker，使用MapComponentController.addMarker接口，返回添加的marker实例 https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/map-map-V5#section0810361284。1.一般没有展示地图，可能和没有配置SHA256指纹证书配置，网络，定位权限，没有打开地图服务等有关系，如果刚配置完权限等，需要24h生效，（可以将手机系统时间往后设置24h）。

创建了一个本地倒计时实况窗，但是胶囊态的显示有点问题，由于胶囊的宽度比较短，无法完全展示出倒计时。对单设备的实况窗activityid管控24小时，发送的activityId对应的实况窗在设备上不存在，将限制给这台设备发送该activityId的实况窗消息24小时。胶囊宽度不可控制，胶囊内容应简要描述当前最重要的信息，尽量3个中文字符长度以内 ，超过后会以跑马灯动效展示剩余内容。请问实况窗文档上说的管控24小时是对设备管控24小时，还是只对生成的实况窗对应的activityid管控24小时？

https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/faq-0000001050166999#section78166185011</map.mapcomponentcontroller></map.mapcomponentcontroller>接入文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/map-location-details-V5。

关于应用跟踪（即OAID权限）的使用，由于当前大多数应用的弹框理由写的不充分，弹框说明理由写的不合理，因此为了能够带来更好的体验，该特性从HDC B025SP86版本开始会先下线进行整改（即申请了按默认拒绝处理，不会进行弹框提示用户同意），修改对应的弹框样式以及同时伙伴的权限使用理由需要进行整改，待整改完成后预计7月30日后重新上线。发送通知消息，收到消息没有声音提醒、没有横幅消息展示，只在通知栏里悄悄展示了。营销消息提醒方式与消息展示位置：静默通知，仅在通知中心展示消息，这可能是造成当前疑惑的原因。

参考文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-device-info-V5。使用identifier.getOAID()获取OAID，官方文档说需要申请APP_TRACKING_CONSENT权限，按照文档申请了报错，日志提示不需要申请，去掉就好了，到底需不需要权限？当前通过OAID生成，但每次重启PC样机，获取到的OAID都会变化，无法满足唯一不变的需求。

App调用scanBarcode.startScanForResult函数使用了扫码服务，扫描成功/失败都能触发callback回调函数，但是用户手动去点击扫码界面左上角的关闭按钮，无法触发callback回调函数。H5想要通过dsbridge调用原生扫码，原生扫码使用的是customScan，但是H5只会掉一次，customScan又是在另一个组件里，如何才能把customScan扫码后的值通过回调的方式传给H5？2、自定义扫码页面实现扫码，获取扫码结果后，返回Web组件的页面，这里需要传参（扫码结果）

在订阅支付场景中传了developerPayload字段，这个字段的值在后续续费的订单数据PurchaseOrderPayload.developerPayload是否会继续回传签约时值呢？iap.queryProducts这个配置不是根据系统语言显示的，是根据注册的国家来显示的，当前账号注册支持中国，所以当前只支持显示中文。订阅场景，如果购买成功，不确认发货，不会退款/解约，仅不能继续续期/购买同组其他商品；1、用户的续费订单是否会给用户退款或解约，如果会退款/解沙盒环境是否有相同的结果？

具体关于华为商户的问题可以参考API文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/payment-kit-guide-V5。2、微信：暂未给出具体发布时间，可关注官网链接：https://pay.weixin.qq.com/docs/merchant/sdk-tools/sdk-tool.html。1、支付宝：鸿蒙支付SDK获取链接：https://opendocs.alipay.com/open/01ysmx。

有效期是应用接收回执服务器的CA证书有效期时间，证书过期将导致您无法接收消息回执，Push并不可以修改时间，需要及时更换回执服务器的证书。1.推送服务的回调地址是以项目维度，同一个项目下如有多个应用（Android，HarmonyOS）则共用一个回调地址，如不同的应用需要区分使用回调地址则需要创建不同的项目配置回调地址。2.如果开发者不方便创建多个项目，push提供receiptId参数，输入一个唯一的回执ID指定本次下行消息的回执地址及配置，该回执ID可以在回执参数配置中查看。

2.服务端需要重新接入，详见：https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/push-scenariozed-api-intro-V5。获取到pageUri之后，应用可以选择是通过跳转的方式跳转到目标页面；1.鸿蒙Push Kit当前使用的是V3场景化接口，将典型的推送场景按照类型拆分为多种场景，不同场景定义为不同push-type，提供基于场景的消息发送，治理和差异化能力，实现更好的消息触达和用户使用体验。

更详细的调用可以参考我们的示例代码：https://developer.huawei.com/consumer/cn/doc/harmonyos-samples-V5/samples-system-0000001940562557-V5#section914717231319。RCP配置certificate配置的是自己的证书？经确认，如果配置的ip或端口不正确不会自动走默认的dns，会直接报连不上之类的报错。在rcp设置静态dns，如果配置的ip或端口不正确，会自动走默认的dns吗?

有效期是应用接收回执服务器的CA证书有效期时间，证书过期将导致您无法接收消息回执，Push并不可以修改时间，需要及时更换回执服务器的证书。证书并不是由AGC生成，Push服务会根据填的回执地址，获取到对应服务器的证书有效期，因此有效期却决于应用服务器的证书。1.鸿蒙Push Kit当前使用的是V3场景化接口，将典型的推送场景按照类型拆分为多种场景，不同场景定义为不同push-type，提供基于场景的消息发送，治理和差异化能力，实现更好的消息触达和用户使用体验。推送通知到手机，怎么配置拉起应用指定的页面？

hvigor命令行指导：https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V2/ide-command-line-hvigor-0000001553317645-V2。hvigor自定义任务指导：https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V2/custom-hvigor-0000001650987753-V2。可以通过hvigor脚本实现。

当前实现隐私模式都是三方应用自己实现，window有个隐私模式接口：https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-window-0000001815246534-V5#ZH-CN_TOPIC_0000001815246534__setwindowprivacymode9，可以实现禁止截屏和录屏。需要做哪些适配工作么？ArkUI-X项目介绍文档： https://gitee.com/arkui-x。

我们这边测试中文是正常，如果反馈中文有问题，麻烦提供一下日志，或者其他能帮助我们查问题的信息，联系方式https://developer.huawei.com/consumer/cn/support/feedback/#/?使用系统分享组件分享本地文件，点击分享菜单下方的“另存为” 将要分享的文件分享至系统文件管理中，在文件管理中查看分享进来的文件为0B。1、uris和action可以同时存在。App需要使用文件分享相关功能，uris是必须配置的，若删除相关配置，则App无法接收消息，请问应该怎么处理。

申请后台音频播放长时间任务失败，报错9800006 Notification verification failed. The title or text of the notification cannot be empty，使用官方的demo可以申请成功，但是移植对应的逻辑到项目中失败，如何解决？1.notificationFlags是NotificationRequest类中定义的属性，这个属性是“只读”类型，因此在使用时，不支持修改notificationFlags的值。文档中搜索不到相关内容。

audio 设置指定流的音量参考API链接：https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-audio-0000001861966901-V5#ZH-CN_TOPIC_0000001881179169__setvolumedeprecated。活体检测页面固定音频流设置的是8（无障碍），获取的是系统无障碍的音量大小。活体检测暂无声音控制开关，但可通过其他能力控制系统音量，从而控制音量。

链接：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-noti-classification-V5，通过之后可以使用。通过华为推送过来的普通消息会在桌面应用图片上显示未读的数字，正常应该是点了顶部通知栏的消息之后，通知栏的这条通知消失，同时图标上的未读数字也要减1，但是目前没有方式可以获取到这个未读消息的数量，也就无法通过setBadgeNumber()去重新设置图标上的未读数字，这个该怎么处理？

应用在AppGallery Connect申请了调试证书、开启了推送服务，app项目中配置了调试证书签名，应用也配置了client_id，但是获取token失败，报错信息 get token fail:, {error.name:Error, error.message:Illegal application identity.} ,json:{“code”:1000900010}}2、VoIP呼叫消息负责拉起应用的进程，在进程内完成通话状态上报弹出呼叫横幅通知，监听通话状态回调，被呼叫页面加载等操作。

立即生效的切换订阅：用户原订阅的剩余金额将折算成新订阅的天数，延长新订阅的有效期。坏账则是指无法收回或收回的可能性极小的应收款项，当前 IAP 不会也不可能出现坏账 ，因为用户购买开发者的应用内商品，只有购买支付成功，应用确认发货之后，用户才能享受到相关的权益；建议可以进入自助结算页面，登录开发者联盟，进入“管理中心”，点击“我的账户”，选择“收益”，进入自助结算页面查看日账单明细。建议可以进入自助结算页面，登录开发者联盟，进入“管理中心”，点击“我的账户”，选择“收益”，进入自助结算页面查看结算单；

参考文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/convertcoordinate-services-V5#section194373053016。4、找到@hms.core.map.MapComponent.d.ets文件，打开后删除 * @bundle com.huawei.hms.mapservice.kit/mapLibrary/ets/MapComponent 5.0.0(12)

2、createAuthorizationWithHuaweiIDRequest，属于获取用户信息的API(https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/account-get-avatar-nickname-0000001649962209-V5)，需要授权，比如获取头像昵称、手机号快速验证这些获取用户信息的接口调用都是要用户授权同意后才能够返回这些数据的。怎么判断登录的华为帐号有变动？

问题分析：订阅后到期不续定的情况，可以再次购买订阅型商品，如果再次订阅显示错误，有可能是在购买环节出了问题，根据CP提供的日志分析发现报1001860001错误码：BusinessError 1001860001: System internal error. product status must 0(online)；针对(1)，用户可以拨打华为客服热线咨询退款。Payment kit是三方支付机构的方式，支持多样化的支付场景，主要支持实物商品，如具体的手机，电脑等，仅支持国内。应用内支付如何发起退款？

关于导航可以参考这两个文档进行地图导航功能编写：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/harmonyos-drawing-map-0000001649463906和https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/advanced-controls-0000001704597046。能否设置点击地图，地图标记上的文字不消失？

通知应用大图标不能超过30kb，通知参数限制，参考如下：https://gitee.com/openharmony/docs/blob/a4772406c6d12809edc9bb407a9a2858b6b19e08/zh-cn/application-dev/reference/apis-notification-kit/js-apis-inner-notification-notificationRequest.md。push-type: 0是推送通知消息，消息在通知栏展示，不会产生回调。

当前开发者的消息类型应该是资讯营销类的消息，消息提醒方式与消息类别的对应关系请参考：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-noti-classification-0000001727885246#section15216442535。可能原因：服务端推送使用的token与设备保存的token不一致，大多数情况是因为您的测试机重新获取了新的token，但是他们还使用旧的推送导致的。

原先使用的是老版本的IDE开发的项目，对应的hvigorVersion也是老版本的。属性说明请参见add接口介绍指南：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/asset-js-add-0000001815758824-V5。

请参考文档：https://developer.huawei.com/consumer/cn/codelabsPortal/carddetails/tutorials_ScanKit-Codelab-Clientdemo-ArkTS。不会解析用户数据，Scan Kit接口只会检测二维码的位置，不会尝试去解码。Scan Kit扫描专用底层码流接口需要鉴权，鉴权失败后功能还能用吗？如果已经申请过白名单，因为异常导致的鉴权失败会优先放通，保障业务成功。