Light Generation Developers

光時代科技開發者網站

SDK 說明文件

光標籤概述

藉由我們光時代科技獨家設計的「光標籤」設備,可以精準定位 Camera 的位置,讓 AR App 不再需要高額建置成本即可達到同樣標準的使用者體驗!

座標系統

在 SDK 中,我們需了解兩個座標系統,「光標籤設備」座標系以及「手機鏡頭」座標系。

「光欄籤設備」座標系可以參考下圖:

光標籤設備-座標系

「手機鏡頭」座標系可以參考下圖:

SDK 提供的資料欄位

  • id (光標籤的 ID)
  • 反向定位 x, y, z (光標籤設備座標系)
  • 旋轉資訊 rotationInfos (光標籤設備座標系)
  • translationInfos 光標籤設備在「手機鏡頭座標系」的位置
  • valid 資訊是否可靠
  • screenX, screenY 光標籤設備在「手機螢幕」上映射的座標百分比

掃描時的預覽畫面

valid 的欄位告訴我們這個光標籤定位資訊的可靠程度超過標準

screenX, screenY 提供預覽畫面的 xy 百分比,請看下圖:

目前預覽畫面設定為手機上半部的中間區域才算有效

如上圖 Positioning Area 就是位於上半部的中間。因此光標籤圖案的 xy 可以由 screenX * 畫面寬度, screenY * 上半部畫面高度 求得 (可參考範例專案)

App Key and Secret

您將需要專屬的 App Key and Secret 來使用 Unity SDK. 若您手上沒有,請洽我們的業務代表。

需要進一步的說明,請看 App Key and Secret

Android SDK

目前發行 AAR 檔案,之後會放到 Apache Maven Repository。

權限要請使用者授權:

  • CAMERA
    • 需要取得相機拍攝到的畫面做辨識
  • WRITE_EXTERNAL_STORAGE 跟 READ_EXTERNAL_STORAGE
    • 寫 Log 檔案作為優化用途
  • INTERNET 跟 ACCESS_NETWORK_STATE
    • 需要偵測網路可用性
  • READ_PHONE_STATE
    • 需要取得手機型號,下載特定之參數優化
  • ACCESS_COARSE_LOCATION 跟 ACCESS_FINE_LOCATION
    • 藉由 Wifi/GPS 來優化使用者體驗

iOS SDK

目前是以 CocoaPods 的方式提供,請在 Podfile 裡面設定如下:

source 'https://gitlab.com/lig_dev/specs.git'

...
pod 'ligsdk'

Info.plist 設定如下:

  • Privacy – Camera Usage Description
  • App Transport Security Settings
    • Allow Arbitrary Loads: YES

Info.plist 要能提供 Camera 的使用權限,及 Non-HTTPS 的存取

Build Settings 請確保:

  • Enable bit code: NO
  • Other Linker Flags: 裡面要有 -ObjC 跟 -l”c++”

Unity SDK

目前是以 unitypackage 檔案發行。使用說明請參照這裡

佈景主題由 Anders Norén 所設計