なんかいろいろしてみます

Apr 15, 2018 - 3 minute read - HoloLens

HoloLens RS4のResearch modeを使ってみる(Unity利用編)

前回,HoloLens RS4での新機能Research modeの紹介とサンプルを動作させてみました. 今回はResearch modeのC#での利用とUnityでの表示方法について紹介します.

概要

前回のHoloLens RS4のResearch modeを使ってみる(サンプル実行編)では公式のサンプルプロジェクトを実行して赤外線情報を取得しました. サンプルプロジェクトではC++での実行でしたがUnityで利用する場合にはC#での実装が便利です.

今回はResearch modeで取得できるセンサ情報をC#とUnityで利用できるようにしてみたいと思います. ついでに赤外線情報以外のセンサデータも取得してみます.

開発環境

  • 開発環境
    • Windows10 Insider Preview 17127
    • Windows10 SDK Insider Preview 17115
    • Visual Studio2017
    • Unity 2017.4.0f1
  • 実行環境
    • HoloLens RS4 Preview 17123

Research modeのC#での利用

始めはC#でのセンサ情報の取得と表示をUWPで行います. プロジェクトを用意したので以下のプロジェクトをダウンロードして開いてください.

https://github.com/akihiro0105/HoloLensResearchmodeDemo

プロジェクトをビルドしてHoloLensで実行することで様々なセンサデータを画像で確認することができます.

プロジェクト設定

HoloLens RS4のResearch modeは通常では利用できない特殊な機能となっています. そのためアプリ作成時の設定にも一部変更を加える必要があります. 追加内容の詳細は以下のサイトにて説明されています.

https://docs.microsoft.com/ja-jp/windows/uwp/packaging/app-capability-declarations

今回使用するプロジェクトでも内容の確認を行います.

  1. HoloLensResearchmodeDemoのPackage.appxmanifestを開いて機能のWebカメラにチェックボックスがONになっていることを確認してください.
  2. Package.appxmanifestを右クリックして「コードの表示」を選択します.
  3. 今回必要な「rescap」の項目を追加します.

    • Packageを以下のようにrescapを追加
1<Package 
2  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10" 
3  xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest" 
4  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10" 
5  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities" 
6IgnorableNamespaces="uap mp rescap">
  • Capabilitiesに <rescap:Capability Name="perceptionSensorsExperimental" />を追加
1<Capabilities>
2    <Capability Name="internetClient" />
3    <rescap:Capability Name="perceptionSensorsExperimental" />
4    <DeviceCapability Name="webcam" />
5  </Capabilities>

データ取得

センサデータを取得するコードを確認していきます.

カメラの取得と初期設定です.

 1  private MediaFrameReader mediaFrameReader = null;
 2  private async void SettingSensorData(int deviceNum,int cameraNum)
 3        {
 4            if (mediaFrameReader != null)
 5            {
 6                await mediaFrameReader.StopAsync();
 7                mediaFrameReader.FrameArrived -= FrameArrived;
 8                mediaFrameReader.Dispose();
 9                mediaFrameReader = null;
10            }
11
12            var mediaFrameSourceGroupList = await MediaFrameSourceGroup.FindAllAsync();
13            var mediaFrameSourceGroup = mediaFrameSourceGroupList[deviceNum];
14            var mediaFrameSourceInfo = mediaFrameSourceGroup.SourceInfos[cameraNum];
15            MediaFrameSourceKind kind = mediaFrameSourceInfo.SourceKind;
16            var mediaCapture = new MediaCapture();
17            var settings = new MediaCaptureInitializationSettings()
18            {
19                SourceGroup = mediaFrameSourceGroup,
20                SharingMode = MediaCaptureSharingMode.SharedReadOnly,
21                StreamingCaptureMode = StreamingCaptureMode.Video,
22                MemoryPreference = MediaCaptureMemoryPreference.Cpu,
23            };
24            try
25            {
26                await mediaCapture.InitializeAsync(settings);
27                var mediaFrameSource = mediaCapture.FrameSources[mediaFrameSourceInfo.Id];
28                if (kind == MediaFrameSourceKind.Color)
29                {
30                    mediaFrameReader = await mediaCapture.CreateFrameReaderAsync(mediaFrameSource, MediaEncodingSubtypes.Argb32);
31                }
32                else
33                {
34                    mediaFrameReader = await mediaCapture.CreateFrameReaderAsync(mediaFrameSource, mediaFrameSource.CurrentFormat.Subtype);
35                }
36                mediaFrameReader.FrameArrived += FrameArrived;
37                await mediaFrameReader.StartAsync();
38            }
39            catch (Exception)
40            {
41                throw;
42            }
43        }

カメラの設定を取得するためにMediaFrameSourceGroupから取得しています. Research modeを有効にしたときにカメラのデバイス番号が変更され

  • 0 : センサデータ
  • 1 : RGBカメラデータ

の設定になっています. センサデータは基本的にMediaStreamType.VideoRecordで出力され,MediaFrameSourceKindはそれぞれのセンサによって異なっています.

  • 赤外線データ : MediaFrameSourceKind.Infrared : MediaEncodingSubtypes.L8
  • Depthデータ : MediaFrameSourceKind.Depth : MediaEncodingSubtypes.D16
  • 環境認識カメラ : MediaFrameSourceKind.Color : MediaEncodingSubtypes.Argb32

となっています. センサのデータ形式によって作成するMediaFrameReaderが異なるのですが,今回はデフォルトの設定を利用するようにしています.

設定後FrameArrivedで画像フレームの到着を待つようにしてMediaFrameReaderをスタートさせます.

 1  private void FrameArrived(MediaFrameReader sender, MediaFrameArrivedEventArgs args)
 2        {
 3            var reader = sender.TryAcquireLatestFrame();
 4            if (reader != null)
 5            {
 6                var videoMediaFrame = reader.VideoMediaFrame;
 7                var softwareBitmap = videoMediaFrame.SoftwareBitmap;
 8                softwareBitmap = SoftwareBitmap.Convert(softwareBitmap, BitmapPixelFormat.Bgra8, BitmapAlphaMode.Premultiplied);
 9                var task = ImageView.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () =>
10                  {
11                      SoftwareBitmapSource softwareBitmapSource = new SoftwareBitmapSource();
12                      await softwareBitmapSource.SetBitmapAsync(softwareBitmap);
13                      ImageView.Source = softwareBitmapSource;
14                  });
15                reader.Dispose();
16            }
17        }

到着した画像データをFrameArrivedで受け取ったあとSoftwareBitmapSourceに変換してUWPのUIのImageに張り付けています. 正常に動作すれば以下の動画のように各センサデータが確認できます.

短距離Depthセンサ

長距離Depthセンサ

短距離赤外線センサ

長距離赤外線センサ

環境認識カメラ左外側

環境認識カメラ左手前

環境認識カメラ右手前

環境認識カメラ右外側

Research modeのUnityでの利用

C#での動作が確認できたのでUnityでも動作を確認していきます. Unity側のデモプロジェクトは以下にあります.

https://github.com/akihiro0105/HoloLensResearchmodeDemoWithUnity

Unityプロジェクトの設定

UWP形式でビルドします.

VisualStudioでの設定

Unity側でビルドしたプロジェクトはResearch modeで必要な.appxmanifestファイルの設定が行われていません. そのためC#プロジェクトと同様に.appxmanifestファイルに以下を追加します.

  • Packageを以下のようにrescapを追加
1<Package 
2xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest" 
3xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10" 
4xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2" 
5xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities" 
6IgnorableNamespaces="uap uap2 mp rescap" 
7xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
8>
  • Capabilitiesに <rescap:Capability Name="perceptionSensorsExperimental" />を追加
1<Capabilities>
2    <Capability Name="internetClient" />
3    <rescap:Capability Name="perceptionSensorsExperimental" />
4    <DeviceCapability Name="webcam" />
5  </Capabilities>

実際の処理はSensorViewControl.cs内に記述されています.

 1  private Texture2D tex = null;
 2    private byte[] bytes = null;
 3
 4private async void InitSensor()
 5    {
 6        var mediaFrameSourceGroupList = await MediaFrameSourceGroup.FindAllAsync();
 7        var mediaFrameSourceGroup = mediaFrameSourceGroupList[0];
 8        var mediaFrameSourceInfo = mediaFrameSourceGroup.SourceInfos[0];
 9        var mediaCapture = new MediaCapture();
10        var settings = new MediaCaptureInitializationSettings()
11        {
12            SourceGroup = mediaFrameSourceGroup,
13            SharingMode = MediaCaptureSharingMode.SharedReadOnly,
14            StreamingCaptureMode = StreamingCaptureMode.Video,
15            MemoryPreference = MediaCaptureMemoryPreference.Cpu,
16        };
17        try
18        {
19            await mediaCapture.InitializeAsync(settings);
20            var mediaFrameSource = mediaCapture.FrameSources[mediaFrameSourceInfo.Id];
21            var mediaframereader = await mediaCapture.CreateFrameReaderAsync(mediaFrameSource, mediaFrameSource.CurrentFormat.Subtype);
22            mediaframereader.FrameArrived += FrameArrived;
23            await mediaframereader.StartAsync();
24        }
25        catch (Exception e)
26        {
27            UnityEngine.WSA.Application.InvokeOnAppThread(() => {
28                Debug.Log(e);
29            }, true);
30        }
31    }
32
33    private void FrameArrived(MediaFrameReader sender, MediaFrameArrivedEventArgs args)
34    {
35        var mediaframereference = sender.TryAcquireLatestFrame();
36        if (mediaframereference != null)
37        {
38            var videomediaframe = mediaframereference?.VideoMediaFrame;
39            var softwarebitmap = videomediaframe?.SoftwareBitmap;
40            if (softwarebitmap != null)
41            {
42                softwarebitmap = SoftwareBitmap.Convert(softwarebitmap, BitmapPixelFormat.Rgba8, BitmapAlphaMode.Premultiplied);
43                int w = softwarebitmap.PixelWidth;
44                int h = softwarebitmap.PixelHeight;
45                if (bytes==null)
46                {
47                    bytes = new byte[w * h * 4];
48                }
49                softwarebitmap.CopyToBuffer(bytes.AsBuffer());
50                softwarebitmap.Dispose();
51                UnityEngine.WSA.Application.InvokeOnAppThread(() => {
52                    if (tex == null)
53                    {
54                        tex = new Texture2D(w, h, TextureFormat.RGBA32, false);
55                        GetComponent<Renderer>().material.mainTexture = tex;
56                    }
57                    for (int i = 0; i < bytes.Length / 4; ++i)
58                    {
59                        byte b = bytes[i * 4];
60                        bytes[i * 4 + 0] = 0;
61                        bytes[i * 4 + 1] = 0;
62                        bytes[i * 4 + 2] = 0;
63                        bytes[i * 4 + 3] = 255;
64                        if (b==0)
65                        {
66                            bytes[i * 4 + 0] = 128;
67                        }
68                        if (b==1)
69                        {
70                            bytes[i * 4 + 0] = 255;
71                        }
72                    }
73                    tex.LoadRawTextureData(bytes);
74                    tex.Apply();
75                }, true);
76            }
77            mediaframereference.Dispose();
78        }
79    }

C#プロジェクト同様にカメラデータからセンサデータを取得,初期化を行っています. 今回はDepthデータを取得して表示しています.

取得されたDepth画像はUnityのTexture2Dで表示するためRGBA32に変換し,Texture2Dとフォーマットを合わせます. UWP側の処理スレッドとUnity側のスレッドが異なるため一旦Byte配列に画像を変換して,Unity側スレッドにてTexture2Dに保存しています. この時Byte配列を編集することで表示の見た目を変更しています.

Depthデータは0~255のbyte配列に格納されていますが,実際にDepthが取れている距離は0~15程度までです. 特に自分の手を表示している距離は0,1程度となっています. そのためこのプロジェクトではDepthデータが0と1の時に表示を行うようにしています.

実行すると以下の動画のように見ることができます.

まとめ

  • C#からResearch mode有効時にアクセスできるセンサデータを取得できた.
  • UnityプロジェクトからもセンサデータにアクセスしてDepthデータを表示することができた.
  • Research modeを利用したプロジェクトは「特殊な用途および制限された用途に関する機能」に分類されるためストアの申請時に制限がある場合があります.