# KUDAN v1.8.0の不具合

## Missing Features

`TrackerBase.RemoveTrackable()`と`TrackerBase.ClearTrackable()`はまだ実装されていません。


## Platform: Unity Editor

### Unity Editor上のカメラが動かない

#### 発生した問題

`KUDAN Unity SDK v1.8.0`にはUnity Editor上を実行したらカメラの映像が取得できない。

##### エラーメッセージ

- `EntryPointNotFoundException: SetMaximumSimultaneousTracking`

- `NullReferenceException: Object reference not set to an instance of an object Kudan.AR.KudanTracker.Update()`
- `Screen position out of view frustum`

#### 再現する方法

1. PCにカメラを接続する (Logitech B525 HD)
2. [XLSOFTのサイトから](https://www.xlsoft.com/en/products/kudan/download.html) `KUDAN Unity SDK v1.8.0`をダウンロードする。
3. `Unity 2020.1.3f1`で新しいプロジェクトを作成する。
4. 作成されたUnityのプロジェクトに`KUDAN Unity SDK v1.8.0`をインポートする。
5. `Project Settings` -> `Player Settings` -> `Other Setting` に入って Bundle ID を`com.xlsoft.kudanar1`に変える。
6. [XLSOFTからのガイド](https://www.xlsoft.com/doc/kudan/ja/development-license-keys/)通りに`KUDAN`のAPIキーを設定する。
7. `KUDAN`のサンプルシーンを開いく
8. プレイボタンでアプリを実行する

## Platform: IOS

### iOSビルドが出来ない

#### 発生した問題

[公式サイトからのガイド](https://www.xlsoft.com/doc/kudan/unity-building-the-app-for-ios/)通りに設定して、UnityからXCodeプロジェクトをビルドすることが成功しましたが、XCode上でビルドすると`libKudanPlugin.a(libKudanPlugin.a-arm64-master.o)`にエラーが発生しました。

#### 再現する方法

1. [公式サイトからのガイド](https://www.xlsoft.com/doc/kudan/unity-building-the-app-for-ios/)通りUnity Editorを設定する。
2. XCodeのプロジェクトを作成する。
3. [公式サイトからのガイド](https://www.xlsoft.com/doc/kudan/unity-building-the-app-for-ios/)通りXCodeのプロジェクトを設定する。
4. XCodeのプロジェクトをビルドする。

## Platform: Android

### カメラ映像が表示されていない

#### 発生した問題

[公式サイトからのガイド](https://www.xlsoft.com/doc/kudan/unity-building-the-app-for-android/)通りに設定してもサンプルシーンを実行したらカメラ映像が見えない（カメラ映像が真っ暗になる状態）

これは解決する方法としてはアプリを開く前にアプリの設定に入ってカメラ権限の設定を有効にすれば解決します。
こちらで開発しているアプリを自動的にカメラ権限を検知して有効させるように実装しましたが、カメラ権限を有効にしてもカメラ映像が見えない、最終的に手動でアプリの再起動が必要。

#### 再現する方法

1. [公式サイトからのガイド](https://www.xlsoft.com/doc/kudan/unity-building-the-app-for-android/)通りUnity Editorを設定する。
2. APKファイルを作成しする。
3. Androidデバイスにインストールする。
4. アプリを実行する。

# 環境設定

| 項目 | 説明 |
| ------------- | ----------------------- |
| Unity バーション | 2020.1.3f1 |
| Kudan バーション | 1.8 |
| Platform | iOS |
| Bundle ID | com.xlsoft.kudanar1 |
| ウェブカメラ | Logitech B525 HD Webcam |
| Xcode バーション | 12 |
| Androidデバイス | Android OS 11 Pixel 4 |

## Editor API Key

GAXAE-F9AQQ-T5MFD-8SBNR-AC74M-P9MGC-BHWL9-MUNE4-A9KQB-W4RH7-4G638-378SD-PXL7L-N5HY6-UG6ZD-NU

## API Key

WBDmRLHaAWDgkMp5ppfqCSwZVHUhW5xwWOzlQGdrJc/Cq8fBz9SPo8ZIYU06y11iCwZHux0DGYKQTieMwqd+CkVNm0SqU01K8aUhJRhIOwqmdr8S3+9sh2+++eCGfAYvdjY2E73nRF+iuqMO0gTuLYZkke46OSEPu/J7uoq7iYkElW8QzWiEDLlUV0WPjS6DGExYakp5MoVM+LSIgjzxPYuu0BemqXdMnJyR/WZgFdmpTflEFdjnnZI66/7ZArFoUi9Krrp4kCPdjypaPbOTqYWdnajxGFTWN54Bp2fXIv8kpd5QLzzubtnpNK078WtE84+5q1+nS0reH3rEaVFM4XpIP0ug25iofJb4G9JZXKZ8PlGI8+zVuZwI3JNkJsbqpuVpH3o6s0dwjjGOgc/A3KVMMoOAWnizxZNbVApYcmYp+sGj26aoNqvCAeNlqPWAnk2wi1300ce01cj7JlzQuL8ANCzpRzv3BENINKQUtnlxaHbeIc4nyGscbIcy0ts8+t+ObJTA1TV3LtYMONtxzPHD88+y3Xv056k1mbPCSJeISpC+uEuYz/BO+ePEqV+PxW3m69blwhttc7FGilpQpeIo5M6R0MlyL4mlLvx74vh0+YMt8L0ykCNq8SzeLPIlTgQQYvPkrgb1HF44Ocfox4yUjpZWJWliEovJd6DJlWs=

## Sources

| 項目 | 説明 |
| :---------------- | :----------------------------------------------------------- |
| Unityのソースコード | https://drive.google.com/file/d/1CRK1LOCm3Z53OxHbzaGez9KQ9TY1A3v9 |
| Unityのログファイル | https://drive.google.com/file/d/1Nm3Jt04-tDRDQeNXb2QIBhVh8LCFVBAC |
| テスト結果 | https://drive.google.com/file/d/1rrrZpou-_Jucrdpjv_0w_XCLxv3KFrbh |
| XCodeのソースコード | https://drive.google.com/file/d/1hOXryj3efSLvWo27i2JiffShTPhytr4Q |
| XCodeのログファイル | https://drive.google.com/file/d/1tVHB8-WG7UffK8YlaF6_c4aZNi-fBGt4 |