# 名词解释

# 通用概念

WMPF

微信小程序硬件框架 (WeChat Mini-Program Framework) 。

小程序框架体验 demo

微信终端合作平台注册账户后,在「快速体验」页面进行下载安装,此 demo 不可修改,只用于 WMPF 在设备上的体验小程序操作。具体操作流程见「快速体验」文档。

小程序框架正式 demo

微信侧提供的 WMPF Client apk 简易版,是 Service 的调用方;开发者需要参考相关文档在正式 demo 的基础上二次开发,形成开发者所需的 WMPF Client 。

WMPF Service apk

又称 WMPF 框架,作为小程序框架的运行环境,微信会定期更新在 WMPF 发布页面更新。

WMPF Client apk

Service 的调用方,又称 launcher ,以 apk 的方式运行在安卓系统中,是小程序的容器。开发者需要根据详细接入流程,完成 Client 的开发(可在微信提供的示例代码基础上二次开发)。

Ticket

在使用体验 demo 时,可以获得运行小程序的临时权限,ticket 是小程序的临时启动凭证。可在微信终端合作平台中生成,有效期为 2 小时。

硬件注册

指获取 Product ID、Device ID、Signature、公私钥等。

# 平台 ID 和硬件注册

HostAppID

又名移动应用 ID ,它用来表示设备的合作方,所有需要运行的小程序都需要将小程序 AppID 与你的移动应用 ID 相绑定。在微信开放平台注册账户后,创建移动应用后获得。参见:创建移动应用绑定移动应用和小程序

AppSecret

相当于移动应用 ID 的密码,用于确保移动应用 ID 由它的创建者使用。在获得移动应用 ID 时,同时会获得相应的 app secret ,请妥善保存。

access_token

参见 HTTP 接口说明

Product ID

它对应一种设备类型,如果你申请了多个设备类型接入 WMPF,你就会获得多个 Product ID 。每一个合作方申请的 Product ID 都是独一无二的。Product ID 会被用于后续的设备信息上传过程中。在 微信终端合作平台 注册账户后,在「管理接入设备」页面中进行添加设备类型后获得。参见登记设备信息

model name

机型的英文名,由开发者决定,在 微信终端合作平台 注册账户后,在「管理接入设备」页面中进行添加机型时提交。参见登记设备信息

公钥

公钥保存在平台方,私钥由合作方本地保管。在登记设备信息步骤中,通过公钥生成工具获得( Shell 方式需要下载相应工具,Java 代码方式可直接复制代码),再上传到 微信终端合作平台中。

KeyVersion

公钥版本号,在 微信终端合作平台注册账户后,在「管理接入设备」页面中进行添加机型时,提交公钥审核通过后获得。参见登记设备信息

Device ID

由开发者决定,一般是根据 imei 或者是 sn 号生成的独一无二的设备标识,需要通过addDevice接口进行注册。

Signature

Device ID 对应设备的签名,在硬件注册步骤中,用 Signature 生成工具,输入私钥文件获得。

Product ID,Device ID,Signature 对应关系

Product ID 代表某一种产品,如微信相框,每个微信相框都有专属的 Device ID 和 Signature ,也就是说出厂的每台微信相框 Product ID 可以相同,但不可以有相同的 Device ID 和Signature 。Device ID 和 Signature 不可一码多机共用。Device ID 和 Signature 不一定要 hard code 在代码中,可以根据机器 sn 码动态生成,也可以动态下发,保证唯一性即可。

# 小程序相关

appId

所要小程序的 appid,注册小程序后,在微信公众平台小程序详情页查看。

AppSecret

和移动应用的 AppSecret 类似。相当于小程序 appId 的密码

access_token

参见 小程序 access_token 文档

AppType

小程序的具体版本,0:正式版; 1:开发版[a.k.a测试版];2:体验版,具体在微信公众平台小程序详情页查看。

sn

小程序生态下的设备唯一标识,同一个小程序 appId 的同一个 model Id 下,sn 不能重复。sn 应与 WMPF 使用的 Device ID 保持一致。

snTicket

接入小程序硬件生态的硬件设备,在小程序内进行某些设备相关操作时的设备票据,例如授权设备进行音视频通话

model Id

接入小程序硬件生态的硬件设备,在微信公众平台申请获得的设备型号 ID。