本記事について

この記事は CoreBluetoothForUnity Advent Calendar 2023 の11日目の記事です。

CoreBluetoothForUnity を開発する上でこの情報を先に知っておけば...!という参考資料がいくつかありました。それについてまとめます。

公式ドキュメント

サンプルはほぼありませんが、設定周りは見る必要があります。

Apple ARKit XR Plugin

これが一番早く知りたかった情報です。実質公式サンプル

Package Manager で Unity Registry を選択
Apple でフィルターをかける
ARKit ARKit XR Plugin が表示される

これをインストール後

Packages > Apple ARKit XR Plugin > Runtime > Frameworks に NativePlugin と連携する部分のコードがあります。

また、Runtime > iOS 以下に NativePlugin が配置されています。
Objective-C で書かれています。

拡張子 .m のファイルは中身も読めます。

中身を読んでもわからない部分は多々あります。

どこで Dispose しているのか
どういう経緯・理由で現在の設計になっているのか
なぜこれ単体でライブラリを切り出していないのか

しかし、どのクラス、struct がどのような関数、役割を持つのか等わかる部分だけでも非常に参考になります。

GitHub にコードが落ちてますが、これは LICENSE 的に大丈夫か怪しいためリンクは貼らないでおきます。

Xamarin の API ドキュメント

こちらも関数名や、実装とても参考になりました。これも宝の山です。

CoreBluetooth
Foundation

ソースコードも見れます。

こちらも Objective-C で書かれています。

ble-plugin-unity

toio の BLE Plugin です。
toio ではどうやってるんだろう？っていうのが確認できました。

Microsoft の関連のドキュメント

公式大事。

Blittable 型と非 Blittable 型

ネイティブ相互運用性のベストプラクティス

SafeHandle

Keijiro さんの MEMO

Swift のポインタ周り

このあたりはいまだにわからない部分も多いです。(OpaquePointer と UnsafePointer どちらを使うべきかとか)

ただ、資料は多いし Swift のポインタ周りの実装はとても扱いやすく感じました。

neuecc さんの csbindgen の記事

コールバックのやり方とか書いてあります。
csbindgen 自体は使い方と、使ってどのくらい良くなるのかがよくわからなかったため使用していません。(NativeMethods のコード自動生成したいため、使いたい気持ちはあります。)

おわりに

本記事では CoreBluetoothForUnity の開発にあたって参考になった資料を紹介しました。ここに載せた資料意外にも Unity の NativePlugin 周りの知見が書かれた多くの Qiita 記事等を参考にしました。これらの資料のおかげで CoreBluetoothForUnity は開発できております。ありがとうございます！