Show / Hide Table of Contents

    小程序AR入门教程


    一、简介

    基于太虚AR核心技术,可在小程序中实现AR效果,支持图像识别和实时跟踪。使用场景更加灵活,用户可获得交互式、沉浸式的体验,提升留存和转化率,可广泛应用于展览展示、新零售、广告海报、大型商圈、智慧旅游、文化创意等领域。

    • 支持微信小程序,用户体验零门槛,点击即可体验
    • 方便快捷的部署方式,便于维护与更新
    • 快速传播,好创意+高品质的AR效果,引爆朋友圈

    二、阅读指南

    本教程演示了如何实现小程序AR功能。

    默认读者您拥有一定的软件使用、应用开发经验。

    教程中会使用到“微信开发工具”,其中只会对基础的使用进行简要说明,更详细的使用信息请访问微信官网查看。

    三、搭建环境

    在进行具体操作前,您需要准备如下资源:

    • 网页浏览器:Chrome浏览器;
    • 示例资源:下载Car_MiniProgramAR.zip,完成解压的文件包含以下内容:
      • Car.jpg:识别的图像(Marker)
      • Car.fbx:展示的模型及动画
      • Car_texture.png:模型的贴图

    四、实现流程

    实现流程分为四步:

    • 第一步、创建项目;
    • 第二步、AR内容编辑;
    • 第三步、项目预览;
    • 第四步、输出工程,进行后续应用层研发。

    第一步、创建项目

    1.1 注册并登录云平台

    打开云平台网址,注册账号并登录。

    网站地址:https://cloud.voidar.net

    1

    1.2 创建新项目

    进入云平台,左侧点击[ 小程序AR服务 ] -> [ 项目管理 ]。

    2

    点击[ 创建新项目 ]。

    3

    弹出界面填写项目名称,本教程中将项目名称定为“MiniProgramAR”。

    点击[ 保存 ],完成项目创建。

    4

    第二步、AR内容编辑

    2.1 进入项目

    点击项目名称,进入项目详情界面。

    5

    2.2 设置识别图像

    点击[ 上传图像 ],进行识别图像的添加。

    6

    弹出窗口如下:

    7

    1. 名称(必填,支持中文)
    2. 自定义数据(选填,可填写返回给客户端的数据,如视频地址、音频地址、从其他云端下载模型等)
    3. 上传识别图像(必填,仅支持jpg格式,且不超过2M)
    Note

    选择解压文件夹中的“Car.jpg”进行上传,完成后点击[ 保存 ]按钮。

    8

    上传完成,项目中新添加了一条记录,“识别评分”项值越高,识别图品质越好。

    9

    2.3 进入AR编辑器

    点击[ 进入AR编辑器 ],进行AR内容的编辑处理。

    10

    启动编辑器后,显示如下:

    11

    2.4 设置模型

    Note

    点击[ 导入模型 ],选择解压文件夹中的“Car.fbx”进行导入。

    12

    右侧"场景模型"中,选中Car。

    13

    右侧"属性窗口"中,可自行进行“名称”、“位置”、“缩放”、“旋转”、“动画”的设置和调整。

    • 缩放设置为(X , Y , Z = 0.0555 , 0.0555 , 0.0555)

    14

    2.5 设置模型贴图

    左下“资源”中,点击[ 模型材质球 ],进行材质设置。

    15

    Note

    右侧属性窗口中点击[ 上传纹理 ],选择解压文件夹中的“Car_texture.png”进行导入。

    16

    可调整贴图的高度和宽度,完成后点击[ 应用 ]。

    17

    导入完成,显示如下:

    18

    第三步、项目预览

    3.1 保存并发布

    Important

    操作完成,右上点击[ 保存并发布 ],保存当前工程,并发布到小程序中进行测试。

    20

    3.2 生成预览小程序码

    关闭编辑器,返回太虚AR开发者后台,点击[ 项目预览 ]。

    22

    自动生成“预览小程序码”。

    23

    3.4 进行预览

    手机打开微信扫一扫,启动小程序。

    24

    识别成功,加载资源。

    25

    资源成功加载,呈现AR内容,完成预览。

    26

    第四步、输出工程

    Important

    小程序AR版本分为“体验版”、“基础版”、“专业版”、“定制版” ,点击查看详情;

    体验版不支持添加插件、输出工程。

    如需升级版本,请与太虚AR商务人员联系,邮箱:bd@voidar.com,QQ:49495629

    4.1 下载工程

    点击[ 输出工程 ],启动工程下载。

    27

    下载完成,解压工程。

    28

    4.2 添加插件

    访问并登录微信公众平台,左下点击[ 设置 ]。

    39

    上方点击[ 第三方设置 ]。

    40

    插件管理中点击[ 添加插件 ]。

    41

    搜索“太虚AR”,选中插件,点击[ 添加 ]。

    42

    界面中可输入申请说明,点击[ 添加 ]。

    43

    添加完成后,将发送申请。

    Important

    请与太虚AR商务人员联系,邮箱:bd@voidar.com,QQ:49495629

    44

    4.3 导入工程

    启动“微信开发者工具“。如果没有该工具,请先下载并安装。

    30

    左侧选择“小程序”,点击[ 导入 ]。

    29

    弹出界面“选择4.1中解压的工程文件夹”,然后点击[ 选择文件夹 ]。

    31

    进行项目设置,然后点击[ 新建 ]。

    • 设置项目名称
    • 设置AppID

    32

    导入成功,首先会进行程序初始化,稍等片刻后将启动摄像头。

    Note

    在微信开发者工具中测试时,需要连接摄像头。

    33

    4.4 应用层研发

    至此,小程序AR制作完成。

    您可以自行进行后续应用层的功能研发,相关接口请查阅开发接口

    Back to top Generated by DocFX