圖像識別（多目標）

Note

支持：Android / iOS / Windows

OSX平臺注意：VOIDAR_Unity_v1.0_Beta4暫時不支持OSX平臺運行，打包iOS正常

一、簡介

用多張細節特征豐富的平面靜態圖像作為標識物（Marker），進行精準識別及跟蹤。

二、閱讀指南

本教程主要介紹如何在Unity環境下進行操作。

默認讀者您擁有一定的軟件使用、應用開發經驗。

教程中只會對Unity的基礎使用進行簡要說明，有關Unity使用的更多信息，請訪問Unity官網查看。

三、搭建環境

在進行具體操作前，您需要安裝下列軟件，準備如下環境：

操作系統

  • Windows 7 或更高版本
  • OS X 10.10 或更高版本

Unity版本支持

Unity 3D版本 太虛AR SDK功能
5.6.x 全部支持
2017.x 全部支持
2018.x 全部支持
2019.1.x 全部支持
2019.2.0 全部支持
Note

本教程中使用的Unity版本為：Unity 2017.4.13

Unity 3D下載地址：https://unity3d.com/cn/get-unity/download/archive

四、實現流程

第一步、新建Unity工程

打開Unity，新建一個工程。填寫Project name為“ImageTarget_multi”、選擇保存的位置，點擊[ Create project ]。

1

第二步、導入太虛AR SDK

選中[ Assets ] -> [ Import Package ] -> [ Custom Package... ]，導入太虛AR SDK。

2

選擇下載好的SDK文件（.unitypackage），點擊[ 打開 ]按鈕。

3

彈出界面，點擊[ Import ]，導入過程需要耐心等待一段時間。

4

如果彈出“API Update Required”界面，請點擊[ I Made a Backup, Go Ahead! ]。

5

第三步、刪除Main Camera

Note

Unity3D打開時默認是新的Scene，新的Scene自帶一個Main Camera和Directional Light對象，我們需要用SDK的ARCamera，故將默認的Camera刪除。

右鍵選中場景中自帶的“Main Camera”，點擊[ Delete ] 刪除。

6

第四步、拖入預制件“ARCamera”、“ImageTarget”

展開[ Assets ] -> [ VoidAR ] -> [ Prefabs ]目錄，

將預制件“ARCamera”和“ImageTarget”分別拖至場景中。

Important

要實現多目標識別，需要拖入對應數量的“ImageTarget”。

本教程將進行2個目標的識別，將2個“ImageTarget”拖入場景。

7

操作成功后顯示如下：

8

第五步、設置ARCamera

選中ARCamera，查看右側的“Inspector”欄，設置“Void AR Behaviour (Script)”組件屬性。

  • 設置MarkerType = "Image"，代表識別類型為圖像
  • 設置Simultaneous Tracking = "2"，代表本次同時跟蹤的識別Marker數量為2個

9

第六步、設置識別圖（Marker）

先選中ImageTarget，查看右側的“Inspector”欄，設置“Image Target Behaviour (Script)”組件屬性。

  • 設置Image File Path = "Panda.jpg"，填寫時需要包括“文件名”+“后綴jpg”

10

Warning

Marker圖片文件，必須放在[ Assets ] -> [ StreamingAssets ]文件夾內，ImageTarget使用的Panda.jpg，是SDK的內置圖片。

11

ImageTarget (1)的識別圖，設定為竹子圖片。

10yuan

右鍵選中StreamingAssets，點擊[ Import New Asset... ]，彈出界面選中Bamboo.jpg并導入。

49

導入完成，如下所示：

50

選中ImageTarget (1)，查看右側的“Inspector”欄，設置Image File Path = "Bamboo.jpg"。

51

第七步、設置模型

Note

識別后顯示的模型，需要分別放在ImageTarget、ImageTarget (1)下。

右鍵選中場景中的“ImageTarget”，添加一個3D模型“Cube”。

12

選中“Cube”，調整模型的位置和大小。

13

右鍵選中場景中的“ImageTarget (1)”，添加一個3D模型“Sphere”。

52

選中“Sphere”，調整模型的位置和大小。

53

第八步、保存場景

選中[ File ] -> [ Save Scenes ] ，進行場景保存。

14

設置文件名為“ImageTarget_multi”，點擊[ 保存 ]按鈕。

15

第九步、進行調試

Warning

確保您的PC已經連接了攝像頭。

點擊[ 運行 ]按鈕。

16

識別成功，完成調試。

17

第十步、打包發布

打包流程分為“Android”、“iOS”、“Windows exe”。

Android

打包Android，需要將Unity切換至Android平臺，點擊[ File ] -> [ Build Settings... ]。

18

選中Android標簽，如果左下的[ Switch Platform ]按鈕為灰色，需要下載Unity Android Support，請點擊右側的[ Open Download Page ]按鈕，下載并安裝。

19

點擊[ Switch Platform ]按鈕，完成Android平臺的切換。

20

切換完成后，先關閉Build Settings界面，繼續搭建打包環境。

選中[ Edit ] -> [ Preferences... ]，設置參數。

47

彈出界面選中“External Tools”選項，設置Android SDK和JDK。

Note

如果本地沒有SDK和JDK，可以點擊后方的[ Download ]，在彈出的網頁上進行下載即可。

也可以用鏈接下載安裝：

SDK（要科學上網才能打開）：https://developer.android.com/studio/index.html

JDK：https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

安裝完成后，設置好SDK和JDK的路徑就可以了。

48

選中ARCamera，查看右側的“Inspector”欄，設置“Void AR Behaviour (Script)”組件屬性。

  • 設置Camera = "后置攝像頭"

27

選中[ File ] -> [ Build Settings... ]，取消默認場景前方的勾選。然后點擊[ Add Open Scenes ]，添加當前的場景。

21

添加完成后，如下所示：

22

設置屬性參數

點擊[ Player Settings... ]按鈕，查看右側的“Inspector”欄，設置屬性參數，您可以自定義。

  • 設置Company = "VOIDAR"

  • 設置Product Name = "ImageTarget_multi"

  • 設置Bundle Identifier= "com.VOIDAR.ImageTargetmulti"（不能使用默認值，否則無法打包）

  • Important

    取消“Multithreaded Rendering”的勾選！

23

完成設置后，點擊[ Build ]按鈕。

24

設置文件名為“ImageTarget_multi”，點擊[ 保存 ]按鈕，開始打包。

25

打包過程需要耐心等待一段時間。

26

完成后，將生成一個“ImageTarget_multi.apk”文件，安卓打包完成。

iOS

iOS打包需要在Mac OS系統中完成，需要準備Mac設備（如MacBook Pro、MacBook、iMac、Mac mini等）。

在Unity中，將開發平臺切換至iOS，然后Build生成Xcode工程。

Warning

推薦使用Mac設備的Unity軟件來生成Xcode工程。如果之前是在Windows環境下編輯的，可以將Unity工程輸出成unitypackage，或拷貝至Mac電腦中進行編輯處理。

啟動Unity，打開之前保存的、或者拷貝過來的ImageTarget_multi工程文件（工程已經打開的，跳過這步）

28

點擊[ Open ]按鈕打開工程。

29

將Unity切換至iOS平臺，點擊[ File ] -> [ Build Settings... ]。

30

選中iOS標簽，如果左下的[ Switch Platform ]按鈕為灰色，需要下載Unity iOS Support，請點擊右側的[ Open Download Page ]按鈕，下載并安裝。

31

點擊[ Switch Platform ]按鈕，完成iOS平臺的切換。

32

切換完成后，點擊[ Player Settings... ]按鈕。

340

Important

取消“Multithreaded Rendering”的勾選！

51

關閉Build Settings界面，選中ARCamera，查看右側的“Inspector”欄，設置“Void AR Behaviour (Script)”組件屬性。

  • 設置Camera = "后置攝像頭"

33

選中[ File ] -> [ Build Settings... ]，取消默認場景前方的勾選。然后點擊[ Add Open Scenes ]，添加當前的場景。

34

添加完成后，如下所示：

35

完成設置后，點擊[ Build ]按鈕。

36

準備生成Xcode工程，命名為“Output”，點擊[ Save ]。

37

打開生成的Xcode文件。

38

設置屬性參數

填寫配置，將自己的證書、iOS適應版本都正確選上：

左側點擊[ Unity-iPhone ]，配置參數，您可以自定義。

  • 設置Display Name = "VOIDAR_Test"
  • 設置Bundle Identifier = "com.VOIDAR.Demo"
  • 設置Version = "1.0"
  • 設置Build = “1.0”
  • 設置Team = “您自己的證書”
  • 設置Deployment Target = “8.1”

39

添加Accelerate.framework

General頁面往下拉，在Linked Frameworks and Libraries中，點擊“+”。

40

彈出界面，選中“Accelerate.framework”，點擊[ Add ]。

41

添加完成，Linked Frameworks and Libraries下方出現“Accelerate.framework”。

42

添加攝像機權限

選中“Info”標簽，點擊Supported interface orientations后面的“+”。在彈出列表中選中“Privacy - Camera Usage Description”。

43

44

設置Enable Bitcode = “No”

選中”Build Settings”標簽，設置Enable Bitcode = “No”。

45

打包取消armv7

選中“Build Settings”標簽，展開Architectures，選擇 “Other...”。

52

彈出界面，選中“armv7”后點擊“-”。

53

取消后顯示如下即可。

54

數據線連接iphone或者ipad，點擊[ 運行 ]，即可打包。

46

完成后，iphone或者ipad上，將生成一個“VOIDAR_Test”的APP，iOS打包完成。

Windows exe

打包Windows exe，需要將Unity切換至PC平臺，點擊[ File ] -> [ Build Settings... ]。

18

選中PC標簽，點擊[ Switch Platform ]按鈕，完成PC平臺的切換。

109

Important

設置Architecture = "x86_64"

341

Warning

確保您的PC已經連接了攝像頭。

選中ARCamera，查看右側的“Inspector”欄，設置“Void AR Behaviour (Script)”組件屬性，選擇對應的攝像頭。

111

選中[ File ] -> [ Build Settings... ]，取消默認場景前方的勾選。然后點擊[ Add Open Scenes ]，添加當前的場景。

110

添加完成后，如下所示：

22

設置屬性參數

點擊[ Player Settings... ]按鈕，查看右側的“Inspector”欄，設置屬性參數，您可以自定義。

1

完成設置后，點擊[ Build ]按鈕。

7

設置文件名為“ImageTarget_multi”，點擊[ 保存 ]按鈕，開始打包。

Important

文件名不能含有“中文”，否則exe運行時會報錯。

113

打包過程需要耐心等待一段時間。

114

完成后，將生成“ImageTarget_multi.exe”文件，Windows exe打包完成。

至此，圖像識別（多目標）制作完成。