DB3502∕T 170-2024“i厦门”平台系统接入及服务入驻规范

ICS35.240

CCSL77

3502

福建省厦门市地方标准

DB3502/T170—2024

“i厦门”平台系统接入及服务入驻规范

SystemaccessandserviceentryspecificationsforiXiamenplatform

2024-12-13发布2024-12-13实施

厦门市市场监督管理局发布

DB3502/T170—2024

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4缩略语2

5接入原则2

6接入流程2

7接口规范6

8安全要求30

9运维要求31

10界面要求31

11发布前审核35

附录A（资料性）关于申请服务对接“i厦门”平台的函36

附录B（资料性）“i厦门”平台服务对接申请表37

附录C（资料性）安全承诺书38

附录D（资料性）界面设计参考样式39

参考文献44

I

DB3502/T170—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由厦门市民数据服务股份有限公司提出。

本文件由厦门市数据管理局归口。

本文件起草单位：厦门市民数据服务股份有限公司、厦门市数据管理局、厦门市信息中心、厦门市

标准化研究院。

本文件主要起草人：纪荣造、蔡婧、韩绍兵、王杨、白毅、蔡跃华、上官慧柏、林晨、李童、余晓

燕、曾焕辉、陈瑀。

II

DB3502/T170—2024

“i厦门”平台系统接入及服务入驻规范

1范围

本文件规定了“i厦门”平台系统接入及服务入驻的接入原则、接入流程、接口规范、安全要求、

运维要求及界面要求。

本文件适用于厦门市各机关、事业单位和公共服务企业的服务应用在“i厦门”平台上的接入及入

驻工作。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T22239—2019信息安全技术网络安全等级保护基本要求

GB/T35273—2020信息安全技术个人信息安全规范

GB/T43506—2023电信和互联网服务用户个人信息保护技术要求

GB/T44248—2024信息技术生物特征识别人脸识别系统应用要求

3术语和定义

下列术语和定义适用于本文件。

3.1

“i厦门”平台iXiaMenplatform

为市民和企业提供权威综合公共服务和便民服务的统一入口,整合各类应用，提供政务、生活、健

康、教育、文化、交通、社保等多领域在线服务，构建市民、企业和政府互联互通体系，“一云多端”

一站式便民利企的服务平台。

3.2

平台主管部门platformadministrationdepartment

负责“i厦门”平台顶层规划和监督管理，协调推动服务事项入驻。

3.3

平台建设单位platformdevelopmentorganization

受主管部门委托，履行平台业主职能，负责平台的建设、运行、运营、审核和安全管理。

3.4

平台运营单位platformoperationorganization

受建设单位的委托，负责平台的研发实施、运行维护和安全管理，为服务的提供方和使用方提供日

常运营服务，保障平台整体安全。

3.5

服务提供单位serviceproviderorganization

服务提供单位是市民服务领域的各机关、事业单位和公共服务企业，是“i厦门”平台的服务提供

方，负责协调落实本单位与平台相关的市民服务事项的入驻管理、数据管理和安全管理。

1

DB3502/T170—2024

3.6

开放平台openplatform

为“i厦门”平台服务提供单位提供统一的发布、运营、管理的一体化服务平台。

4缩略语

下列缩略语适用于本文件。

APP：移动端应用程序（Application）

CSS：层叠样式表（CascadingStyleSheets）

H5：第五版标准通用标记语言（HyperTextMarkupLanguageV5.0）

JS：开发互联网页面的脚本语言（JavaScript）

Json：基于JavaScript语法子集的开放标准数据交换格式（JavaScriptObjectNotation）

SDK：软件开发工具包（SoftwareDevelopmentKit）

5接入原则

5.1统一接入流程

接入服务应按照统一的接入流程进行接入、开发与发布。

5.2统一接口规范

接入服务应按照统一的接口规范与“i厦门”平台进行数据交互和服务能力开发。

5.3统一安全要求

接入服务应符合“i厦门”平台统一的安全要求，保障服务应用及数据安全。

5.4统一运维要求

接入服务应符合“i厦门”平台统一的运维要求，保障服务应用的稳定性及可用性。

5.5统一界面风格

接入服务应符合“i厦门”平台统一的界面设计要求，实现界面风格统一、用户交互体验一致。

6接入流程

6.1接入总体流程

“i厦门”平台入驻流程主要分为应用接入流程、应用变更流程及应用暂停或终止流程三大流程，

见图1-图3。

2

DB3502/T170—2024

图1应用接入流程

图2应用变更流程

3

DB3502/T170—2024

图3应用暂停或终止流程

6.2接入申请

6.2.1提交申请

服务提供单位向“i厦门”平台建设单位提出书面入驻申请，平台建设单位应在5个工作日内，组织

平台运营单位做好对接服务，开展入驻服务的测试和上线工作。入驻申请材料包括《关于申请服务对接

“i厦门”平台的函》、《“i厦门”平台服务对接申请表》及《安全承诺书》，见附录A、附录B及附录

C。

6.2.2分配账号

“i厦门”平台运营单位通过线上或线下发送开放平台账号给服务提供单位，账号分配内容包含“i

厦门”接入平台地址、登录账号及登录密码。

6.3应用创建

6.3.1创建系统

服务提供单位收到分配账号后，登录开放平台填写系统信息、服务承建单位信息、系统保护评定评

级信息后创建系统。

6.3.2创建应用

服务提供单位填写应用基本信息、测试环境信息、正式环境信息、服务承建单位信息，创建应用后

可获取应用联调参数。

6.4应用开发

6.4.1功能开发

服务不应含有任何非法内容，不应进行任何违法行为且不应违反社会公德，服务提供单位依据入驻

申请的建设内容对应用进行开发。

6.4.2测试联调

服务提供单位在开发过程中，使用平台提供的服务能力，应指定专人与平台运营单位进行开发对接

与测试联调。

4

DB3502/T170—2024

6.5应用发布

6.5.1测试版发布

测试版发布应遵循以下流程：

——上传测试版程序包，生成版本记录；

——生成测试二维码，扫码进行测试；

——测试通过后，生成正式环境密钥。

6.5.2正式发布

服务应用正式发布前应提交审核，并进行以下操作：

——确认发布的版本号、版本更新说明、应用类型、首页地址和单点登录地址；

——上传“测试报告”和“操作手册”；

——选择是否审核通过后立即上线。若“是”，则审核通过后生产版本立即切换，若“否”，则审核

通过后可通过版本管理页面，设置版本上线时间；

——提交正式版本审核。提交审核后，等待平台运营单位对服务版本进行审核，审核结果将同步

推送通知给服务提供单位；

——服务提供单位可在审核记录中查看提交审核版本与审核情况。

6.6应用变更

6.6.1变更申请

服务提供单位需要变更服务内容的，应向平台建设单位发起变更申请，变更申请流程见6.2.1。

6.6.2功能修改

服务提供单位根据实际需求对应用进行变更，应用变更应填写更新内容，且应再次进行测试版本发

布。

6.6.3测试版发布

应用变更测试版发布应遵循以下流程：

——上传变更后的测试版程序包，生成版本记录；

——生成测试二维码，扫码进行测试。

6.6.4正式发布

应用变更正式发布前应提交审核，并进行以下操作：

——确认发布的版本号、版本更新说明、应用类型、首页地址和单点登录地址；

——上传变更后版本“测试报告”与变更后版本“操作手册”；

——选择是否审核通过后立即上线。若“是”，则审核通过后生产版本立即切换，若“否”，则审核

通过后可通过版本管理页面，设置版本上线时间；

——提交正式版本审核。提交审核后，等待平台运营单位对服务版本进行审核，审核结果将同步

推送通知给服务提供单位；

——服务提供单位可在审核记录中查看提交审核版本与审核情况。

5

DB3502/T170—2024

6.7应用暂停或终止

6.7.1暂停或终止申请

服务事项需暂停或终止的，服务提供单位应至少提前5个工作日向平台建设单位报备。平台建设单

位在收到申请后5个工作日内完成审核，审核通过后通知平台运营单位办理服务暂停或下线。

6.7.2正式下线

需暂停或终止的服务应用，由平台运营单位提前10个工作日通过“i厦门”平台统一发布公告。如

遇特殊情况紧急暂停或下线的，平台运营单位应向平台建设单位报备后给予执行，待服务提供单位完成

整改和测试以后再予以恢复上线。

7接口规范

7.1单点登录

7.1.1第三方应用接入流程

第三方系统接入流程见图4，图中code获取见。

6

DB3502/T170—2024

图4第三方系统接入流程图

7.1.2推送式单点登录接口

获取授权码

获取授权码接口说明见表1。用户允许授权后，将会重定向到redirect_uri的网址上，并附带code

参数，返回结果参数见表2。

7

DB3502/T170—2024

表1推送式单点登录获取授权码接口

说明前端发起请求，获取授权码

请求URL认证服务器地址/oauth/authorize

请求方式GET

参数名必选说明参数名

client_id是string第三方系统唯一标识

response_type是string固定值=code

grant_type是string固定值=authorization_code

scope是string固定值=snsapi_base

redirect_uri是string授权后重定向的回调链接地址，此参数需放在后面

注：将参数组装拼接在请求URL后。

示例：

redirect_uri?code=CODE&state=STATE

表2推送式单点登录获取授权码返回参数

参数名类型说明

codestring授权码，用于后台获取调用凭证（access_token）

获取调用凭证

获取调用凭证接口说明见表3，返回结果参数见表4，表4中接口作用域（scope）的可调用接口列表

见表5。

表3推送式单点登录获取调用凭证接口

说明采用OAuth2.0的授权码模式，根据授权码获取调用凭证（access_token）

请求URL认证服务器地址/oauth/token

请求方式POST

参数名必选类型说明

code是string填写第一步获取的code参数

client_id是string第三方系统唯一标识

client_secret是string第三方系统密钥

grant_type是string填authorization_code

redirect_uri是string回调地址,必须与上一步一致

注：参数组装在请求URL上，如：请求URL?Code=XXX&client_id=XXX。

表4推送式单点登录获取调用凭证接口返回参数

参数名类型说明

access_tokenstring接口调用凭证

refresh_tokenstring用户刷新access_token

expires_instringaccess_token接口调用凭证超时时间，单位（秒）

scopestring用户授权的作用域，使用逗号（,）分隔

rolesstring角色(ROLE_USER,ROLE_CLIENT)

8

DB3502/T170—2024

表4（续）

参数名类型说明

userNamestring用户名

userIdstring用户id（userId）

表5接口作用域可调用接口列表

授权作用域获取用户资源接口说明

snsapi_base/resource/user/base只包括用户id,用户名

snsapi_baseinfo/resource/user/baseinfo用户基本信息

snsapi_userinfo/resource/user/userinfo用户基本信息和敏感信息(身份证,认证资料,资料库等)

示例：

{

"access_token":"ACCESS_TOKEN",

"token_type":"bearer",

"refresh_token":"REFRESH_TOKEN",

"expires_in":604799,

"scope":"snsapi_base",

"roles":[{

"authority":"ROLE_USER"

}],

"userName":,

"userId":"0854579e9cea4be98c6122c9f0671135",

"jti":"1578a3e2-26a4-4252-8a54-0c44a7447763"

}

获取用户信息

获取用户信息接口说明见表6。获取用户信息后应符合GB/T43506—2023中7.3条款要求，保护用户

个人信息。

表6获取用户信息接口

说明获取用户信息，根据第一步获取授权码的参数scope，调用对应的获取用户接口

请求URL资源服务器地址/resource/user/base

请求方式POST

参数名必选类型说明

access_token是string调用凭证

注：参数组装在请求URL上，如：请求URL?access_token=XXX

示例：

{

{

"status":1,//请求状态1成功0失败

"code":0,//异常码

9

DB3502/T170—2024

"content":{//请求结果

"id":"",//用户标识

"nickname":"",//用户昵称

"photoUrl":null,//用户头像

"phone":"",//用户账号

"gender":1,//用户性别

"name":"",//用户真实姓名

"telephone":"",//用户联系号码

"email":"",//用户邮箱

"userType":1,//用户类型

"authType":1,//认证类型

"userTypeEn":"Citizen",//用户类型英文

"authTypeEn":"PASSED_BASICREALNAME",//认证类型英文

"userAuth":{//用户认证信息

"realName":"",//姓名

"cardId":"",//常用证件号码

"cardType":1,//常用证件代码

"cardTypeCn":"大陆身份证",//常用证件名称

"status":2//认证状态

},

enterAuth":null

},

"message":null//异常信息

}

7.1.3SDK方式单点登录

获取调用凭证

获取调用凭证接口说明见表7，返回结果参数见表8。

表7SDK方式单点登录获取调用凭证接口

说明采用Oauth2.0的客户端模式获取access_token

请求URL认证服务器地址/oauth/token

请求方式POST

参数名必选类型说明

grant_type是string填client_credentials

scope是string填client_baseinfo

client_id是string第三方系统唯一标识

client_secret是string第三方系统密钥

注：参数组装在请求URL上，如：请求URL?scope=XXX&client_id=XXX...

10

DB3502/T170—2024

表8SDK方式单点登录获取调用凭证返回参数

参数名类型说明

access_tokenstring接口调用凭证

token_typestring接口调用凭证类型

expires_instringaccess_token接口调用凭证超时时间，单位（秒）

scopestring用户授权的作用域，使用逗号（,）分隔

注：客户端模式获取的access_token只能调用客户端特有的功能

示例：

{

"access_token":"ACCESS_TOKEN",

"token_type":"bearer",

"expires_in":604799,

"scope":"client_baseinfo",

"jti":"24f10f91-49b0-46e9-95fc-e07e12b89895"

}

获取用户信息

获取用户信息接口说明见表9。

表9SDK方式单点登录获取用户信息接口

说明根据APP的TOKEN获取用户信息

请求URL资源服务器地址/resource/client/user/getUserByToken？access_token=XXX

请求方式POST

参数名必选类型说明

token是string客户端APP的TOKEN，APP打开第三方SDK时以参数的形式传进SDK

示例：

{

"status":1,

"code":0,

"content":{

},//用户信息

"message":null

}

7.2移动端开放能力接入

7.2.1开放能力接入流程

移动端开放能力流程见图5，系统支持iOS、Android和HarmonyOS，7.2中示例采用JS语法格式。

11

DB3502/T170—2024

图5移动端开放能力流程

7.2.2APP与H5交互接口

获取与设置

.1获取设备id

用于获取APP设备id。其中：

——Android方法：android.getDeviceId()；

——HarmonyOS方法：harmony.getDeviceId()；

——iOS方法：innoPlus.device.uuid。

.2获取APP系统类型

判断在APP嵌在Android、HarmonyOS、iOS内，分别判断android、harmony和innoPlus对象是否存在。

其中：

——Android方法：typeof(android)!=="undefined"；

12

DB3502/T170—2024

——HarmonyOS方法：typeof(harmony)!=="undefined"；

——iOS方法：typeof(innoPlus)!=="undefined"。

.3获取APP名称

用于获取App名称，方法返回字符串“ixiamen”。其中：

——Android方法：android.getAppName()；

——HarmonyOS方法：harmony.getAppName()；

——iOS方法：innoPlus.device.appname。

.4获取APP基础参数

用于获APP基础参数，返回结果见示例。其中：

——Android方法：android.getBaseParams()；

——HarmonyOS方法：harmony.getBaseParams()；

——iOS方法：innoPlus.baseParam。

示例：

{

appId:"",

siteId:"",

siteAreaCode:""

}

.5设置APP头部标题

用于设置APP标题栏的标题。其中：

——Android方法：android.setTitle(title)；

——HarmonyOS方法：harmony.setTitle(title)；

——iOS方法：innoPlus.native.setTitle(title)。

控制类操作

.1打开APP页面

用于跳转到APP内部页面。其中：

——Android方法：android.openWindow(path)；

——HarmonyOS方法：harmony.openWindow(path)；

——iOS方法：innoPlus.native.openWindow(path)。

.2后退

用于调用APP后退方法。其中：

——Android方法：android.back()；

——HarmonyOS方法：harmony.back()；

——iOS方法：innoPlus.native.back()。

.3关闭

用于调用APP关闭webview窗口的方法。其中：

13

DB3502/T170—2024

——Android方法：android.close()；

——HarmonyOS方法：harmony.close()；

——iOS方法：innoPlus.native.close()。

.4隐藏头部

用于隐藏APP头部（标题栏）。其中：

——Android方法：android.hideHeader()；

——HarmonyOS方法：harmony.hideHeader()；

——iOS方法：innoPlus.native.hideNavbar()。

登录与认证

.1打开登录页

用于跳转到APP内部页面。其中：

——Android方法：android.openLogin()；

——HarmonyOS方法：harmony.openLogin()；

——iOS方法：innoPlus.native.openLoginPage()。

.2根据身份证信息进行人脸认证

用于调用APP人脸认证，传入json字符串(jsonStr)。安卓或鸿蒙设备，应在全局对象window下注册

一个方法，将方法名作为参数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数

需设置一个参数来接收传递的地址数据。其中：

——Android方法：android.faceAuthWithRegister("functionName",jsonStr)；

——HarmonyOS方法：harmony.faceAuthWithRegister("functionName",jsonStr)；

——iOS方法：innoPlus.native.faceAuthWithRegister(callback,jsonStr)。

示例1：

{

cardId:"3505...X",

name:"张三"

}

示例2：

安卓设备

window.functionName=function(data){}

android.faceAuthWithRegister("functionName",jsonStr)

示例3：

鸿蒙设备

window.functionName=function(data){}

harmony.faceAuthWithRegister("functionName",jsonStr)

示例4：

iOS设备

varcallback=function(data){}

innoPlus.native.faceAuthWithRegister(callback,jsonStr)

14

DB3502/T170—2024

.3调用APP人脸认证页面（是否高级认证）

用于调用APP人脸认证，传入json字符串(jsonStr)。安卓或鸿蒙设备，应在全局对象window下注册

一个方法，将方法名作为参数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数

需设置一个参数来接收传递的地址数据。其中：

——Android方法：android.faceAuthWithAEO("functionName",jsonStr)；

——HarmonyOS方法：harmony.faceAuthWithAEO("functionName",jsonStr)；

——iOS方法：innoPlus.native.faceAuthWithAEO(callback,jsonStr)。

示例1：

{

isAEO:"true"||"false"

}

示例2：

安卓设备

window.functionName=function(data){}

android.faceAuthWithAEO("functionName",jsonStr)

示例3：

鸿蒙设备

window.functionName=function(data){}

harmony.faceAuthWithAEO("functionName",jsonStr)

示例4：

iOS设备

varcallback=function(data{}

innoPlus.native.faceAuthWithAEO(callback,jsonStr)

.4APP登录回调

用于调用APP登录后回调获取用户信息以及处理登录后续操作。安卓或鸿蒙设备，应在全局对象

window下注册一个方法，将方法名作为参数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给

方法，js函数需设置一个参数来接收传递的地址数据。其中：

——Android方法：android.APPLoginWithCallback("functionName")；

——HarmonyOS方法：harmony.APPLoginWithCallback("functionName")；

——iOS方法：innoPlus.native.APPLoginWithCallback(callback)。

示例1：

安卓设备

window.functionName=function(data){}

android.APPLoginWithCallback(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.APPLoginWithCallback(“functionName”)

示例3：

iOS设备

15

DB3502/T170—2024

varcallback=function(data{}

innoPlus.native.APPLoginWithCallback(callback)

功能类操作

.1选择代理企业列表

用于选取代理企业列表。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为参

数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传递

的地址数据。其中：

——Android方法：android.selectAgentEnterprise("functionName")；

——HarmonyOS方法：harmony.selectAgentEnterprise("functionName")；

——iOS方法：innoPlus.native.selectAgentEnterprise(callback)。

示例1：

安卓设备

window.functionName=function(data){}

android.selectAddress(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.selectAddress(“functionName”)

示例3：

iOS设备

varcallback=function(data){}

innoPlus.native.selectAddress(callback)

.2调用APP地址选择

用于调用APP地址选择控件，获取地址。安卓或鸿蒙设备，应在全局对象window下注册一个方法，

将方法名作为参数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个

参数来接收传递的地址数据。其中：

——Android方法：android.selectAddress("functionName")；

——HarmonyOS方法：harmony.selectAddress("functionName")；

——iOS方法：innoPlus.native.selectAddress(callback)。

示例1：

安卓设备

window.functionName=function(data){}

android.selectAddress(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.selectAddress(“functionName”)

示例3：

iOS设备

16

DB3502/T170—2024

varcallback=function(data){}

innoPlus.native.selectAddress(callback)

.3获取当前位置信息

用于获取当前位置信息。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为参

数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传递

的地址数据。其中：

——Android方法：android.getLocationInfo("functionName")；

——HarmonyOS方法：harmony.getLocationInfo("functionName")；

——iOS方法：innoPlus.native.getLocationInfo(callback)。

示例1：

安卓设备

window.functionName=function(data){}

android.getLocationInfo(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.getLocationInfo(“functionName”)

示例3：

iOS设备

varcallback=function(data){}

innoPlus.native.getLocationInfo(callback)

.4获取当前位置坐标

用于获取当前位置坐标。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为参

数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传递

的地址数据。其中：

——Android方法：android.getLocationCoordinate("functionName")；

——HarmonyOS方法：harmony.getLocationCoordinate("functionName")；

——iOS方法：innoPlus.native.getLocationCoordinate(callback)。

示例1：

安卓设备

window.functionName=function(data){}

Android.getLocationCoordinate(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.getLocationCoordinate(“functionName”)

示例3：

iOS设备

varcallback=function(data){}

innoPlus.native.getLocationCoordinate(callback)

17

DB3502/T170—2024

.5调用导航

用于调用APP导航，传递json字符串。其中：

——Android方法：android.navigation(JSON.stringify(obj))；

——HarmonyOS方法：harmony.navigation(JSON.stringify(obj))；

——iOS方法：innoPlus.map.nav(JSON.stringify(obj))。

示例：

varobj=

{

"startLng":"起点经度",

"startLat":"起点纬度",

"endLng":"终点经度",

"endLat":"终点纬度"

}

.6APP搜索地址页

用于调用APP搜索地址的页面，可传入建筑物名称，勾选对应的地址，选择后回调返回地址信息。

安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为参数传递给安卓或鸿蒙提供的方

法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传递的地址数据。其中：

——Android：android.selectLocalAddress("functionName")；

——HarmonyOS方法：harmony.selectLocalAddress("functionName")；

——iOS方法：innoPlus.native.selectLocalAddress(name,callback)。

示例1：

安卓设备

window.functionName=function(data){}

android.selectLocalAddress(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.selectLocalAddress(“functionName”)

示例3：

iOS设备

varcallback=function(data{}

innoPlus.native.selectLocalAddress(name,callback)

.7复制文本

用于复制文本。其中：

——Android方法：android.copyToClipboard(str)；

——HarmonyOS方法：harmony.copyToClipboard(str)；

——iOS方法：innoPlus.native.paste(str)。

.8拨打电话

安卓系统通过调用原生方法传入电话，实现拨打电话，iOS系统通过h5的a标签实现。其中：

18

DB3502/T170—2024

——Android：android.openDial(phoneNumber)；

——HarmonyOS方法：hamorny.openDial(phoneNumber)；

——iOS方法：<ahref="tel:110"></a>。

图文操作

.1APP发起扫码

调用APP端扫码功能。其中：

——Android：调用android.openScanning()；

——HarmonyOS方法：调用harmony.openScanning()；

——iOS方法：innoPlus.native.openScanning()。

.2APP获取扫码信息

用于获取扫描二维码信息。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为

参数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传

递的地址数据。其中：

——Android方法：android.openScanningWithBlock("functionName")；

——HarmonyOS方法：harmony.openScanningWithBlock("functionName")；

——iOS方法：innoPlus.native.openScanningWithBlock(callback)。

示例1：

{

"result":result,

"content":content

}

示例2：

安卓设备

window.functionName=function(data){}

android.openScanningWithBlock(“functionName”)

示例3：

鸿蒙设备

window.functionName=function(data){}

harmony.openScanningWithBlock(“functionName”)

示例4：

iOS设备

varcallback=function(data){}

innoPlus.native.openScanningWithBlock(callback)

.3APP图片预览

调用APP端图片预览功能。其中：

——Android方法：android.photoBroswer(JSON.stringify(obj))；

——HarmonyOS方法：harmony.photoBroswer(JSON.stringify(obj))；

——iOS方法：innoPlus.native.photoBroswer(JSON.stringify(obj))。

19

DB3502/T170—2024

示例：

varobj={

index:0,//当前显示的图片

pictures:["imgSrc","imgSrc2"]//图片路径数组

}

.4PDF文档预览

用于预览PDF文档。传入文档名称，文档的路径，iOS方法传递的参数为对象的字符串。其中：

——Android方法：android.openPDF(fileName,fileUrl)；

——HarmonyOS方法：harmony.openPDF(fileName,fileUrl)；

——iOS方法：innoPlus.native.previewPDF(JSON.stringify(params))。

示例：

varparams={

fileName:fileName,

fileUrl:fileUrl

};

JSON.stringify(params)

文件操作

.1选择文件

用于选取文件附件。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为参数传

递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传递的地

址数据。其中：

——Android方法：android.selectMaterial("functionName",MAX_SIZE)；

——HarmonyOS方法：harmony.selectMaterial("functionName",MAX_SIZE)；

——iOS方法：innoPlus.native.selectMaterial(callback,MAX_SIZE)。

注：MAX_SIZE为可选文件大小，不大于4194304byte。

示例1：

安卓设备

window.functionName=function(data){}

android.selectMaterial(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.selectMaterial(“functionName”)

示例3：

iOS设备

varcallback=function(data){}

innoPlus.native.selectMaterial(callback)

20

DB3502/T170—2024

.2生成文件

用于选取生成文件。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将方法名作为参数传

递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法，js函数需设置一个参数来接收传递的地

址数据。其中：

——Android方法：android.generateMaterial("functionName",MAX_SIZE)；

——HarmonyOS方法：harmony.generateMaterial("functionName",MAX_SIZE)；

——iOS方法：innoPlus.native.generateMaterial(callback,MAX_SIZE)。

注：MAX_SIZE为可选文件大小，不大于4194304byte。

示例1：

安卓设备

window.functionName=function(data){}

android.generateMaterial(“functionName”)

示例2：

鸿蒙设备

window.functionName=function(data){}

harmony.generateMaterial(“functionName”)

示例3：

iOS设备

varcallback=function(data){}

innoPlus.native.generateMaterial(callback)

.3生成文件（自定义文件名）

用于选取生成文件,可自定义文件名。安卓或鸿蒙设备，应在全局对象window下注册一个方法，将

方法名作为参数传递给安卓或鸿蒙提供的方法。iOS设备，将js函数传递给方法,，js函数需设置一个参

数来接收传递的地址数据。其中：

——Android方法：android.createMaterial("functionName",MAX_SIZE)；

——HarmonyOS方法：harmony.createMaterial("functionName",MAX_SIZE)；

——iO