針對微軟正式版 Kinect for Windows SDK 的 kinect-mssdk-openni-bridge

首先，在 User Generator 的部分，主要是透過 production node 的名稱（name）來做使用上的控制。如果要在 OpenNI 內建立這個 bridge 提供的 user generator 的話，需要在建立時、透過 query 來加上名稱的指定。如果是使用 XML 來進行初始化（請參考《使用 XML 設定檔來初始化 OpenNI》）的話，他的寫法會是：

<OpenNI>
  ...
  <ProductionNodes>
    ...
    <Node type="User" name="User1">
      <Query>
        <Name>KinectSDKUserSkeletonGenerator</Name>
      </Query>

    </Node>
    ...
  </ProductionNodes>
</OpenNI>

重點就是要加上 <Query>、並且指定 <Name> 為「KinectSDKUserSkeletonGenerator」了～

而如果是要寫在程式裡的話，則是使用 xn::Query 來做控制：

xn::Query mQuery;
mQuery.SetName( "MSRKinectUserSkeletonGenerator" );
xn::UserGenerator mUserGenerator;
mUserGenerator.Create( mContext, &mQuery );

另外要注意的是，這個 User Generator 是採用不需要標準校正姿勢的架構（請參考《不用校正姿勢的 NITE 1.5》），如果程式的人體骨架追蹤使採用早期、需要使用「Psi」 標準校正姿勢的架構來寫的話（請參考《透過 OpenNI / NITE 分析人體骨架》），那則需要把上面所使用的「KinectSDKUserSkeletonGenerator」這個名稱，改成「KinectSDKUserSkeletonGeneratorWithPsiPoseEmulation」來模擬 Psi 姿勢偵測的事件。

深度感應器的建立方法，應該是沒有什麼特別的，和之前一樣使用就可以了；不過雖然深度感應器支援 QVGA（320×240）和 VGA（640×480）兩種解析度（MapOutputMode），但是就算設定為 VGA 模式，在有使用上面的 User generator 的情況下，解析度會被強制設定為 QVGA、然後模擬成 VGA，這是使用上可能要注意的。

另外，新版的 Bridge 也支援了 Kinect for Windows Hardware 的「Near mode」，要使用的話是透過 Depth Generator 的「nearMode」這個屬性（Property）來做設定；以 XML 來說，要啟用 Near mode 的寫法是：

<Node type="Depth" name="Depth1">
  <Configuration>
    <Property type="int" name="nearMode" value="1"/>
  </Configuration>
</Node>

而對應到程式裡面，應該就是像下面這樣了：

xn::DepthGenerator xDepthGen;
xDepthGen.Create( mContext );
xDepthGen.SetIntProperty( "nearMode", 1 );

最後，Bridge 所提供的 depth generator 還可以設定讓深度值太近、太遠、以及未知的這三種狀況，回傳不同的值（OpenNI 預設這三種狀態都是無法偵測、都是回傳「0」）；要控制這項功能的開啟與否的話，則是針對「distinctOverflowDepthValues」這個屬性來做控制，基本上方方法和上面的「nearMode」相同。

Bridge 所提供的 Image Generator 似乎只有提供 VGA(640×480) 和 1280×1024 @15FPS 這兩種解析度，似乎不支援 QVGA，這點是在使用時要注意的。

Kinect 的馬達角度的控制，主要是透過 Image Generator、Depth Generator 或 User Generator 的「cameraElevationAngle」這個屬性來做控制的。他的設定方法，基本上就是下面這樣的形式：

XnUInt64 angle = 10;
xDepthGen.GetIntProperty( "cameraElevationAngle", angle );
xDepthGen.SetIntProperty( "cameraElevationAngle", angle );

另外，如果要進一步控制的話，也可以透過「nuiSensorPointer」這個屬性，來取得 Kinect for Windows SDK 裡的「INuiSensor」的物件指標、透過強制轉型的方法來進行操作；下面就是使用的範例：（個人是覺得這樣的用法還滿危險的…）

XnUInt64 i;
xDepthGen.GetIntProperty("nuiSensorPointer", i);
INuiSensor* pSensor = (INuiSensor*)i;
pSensor->NuiXxx(...); 

這邊要注意的是，馬達的控制功能功能只有在開始產生資料（StartGeneratingAll()）後才可以使用。

最後，這個版本的 Bridge 在 User Generator 的部分還提供了可以針對使用者自動調整馬達角度的功能！要開啟這項功能，則是要把 User Generator 的名稱，從本來的「KinectSDKUserSkeletonGenerator」改成「KinectSDKUserSkeletonGeneratorWithAutoElevation」。

Audio Generator 的部分，其實 Heresy 自己在 OpenNI 也都沒有用過，所以其實也不是很熟。而在這邊，Bridge 所提供的 Audio Generator 除了可以取得原始聲音資料外，應該是也把 Kinect for Windows SDK 針對聲音做處理的各項功能以屬性的方式移植過來了～ 下面就是他的 XML 設定的說明：

<Node type="Audio" name="Audio1">
  <Configuration>
    <!-- Beam forming mode
         0: Adaptive (Controlled by Kinect-specific DSP)
         1: Automatic (Controlled by DMO)
         2: Manual (Controlled by the application via the beamAngle property
                    explained later) -->
    <Property type="int" name="beamAngleMode" value="0"/>
    <!-- Automatic gain control: 0(off), 1(on) -->
    <Property type="int" name="automaticGainControl" value="0"/>
    <!-- Echo cancellation (AEC) and suppression of residual signal (AES)
         0: None
         1: AEC
         2: AEC and AES once
         3: AEC and AES twice -->
    <Property type="int" name="echoCancellationMode" value="2"/>
    <!-- Center clipping (a technique to remove the residual signal after AEC) and
         Noise filling (a technique to make the sound natural by using a small
         amount of noise instead of silence after removing the residual signal)
         0: None
         1: Center clipping
         2: Center clipping and Noise filling   -->
    <Property type="int" name="centerClippingMode" value="0"/>
    <!-- Noise suppression: 0(off), 1(on) -->
    <Property type="int" name="noiseSuppression" value="1"/>
    <!-- Audio buffer size in milliseconds. The audio data is
         lost unlsee the application polls the audio data
         within this interval. Set before StartGenerating. -->
    <Property type="int" name="bufferSizeInMs" value="1000"/>
  </Configuration>
</Node>

而在程式中要取得相關的數值的話，基本上就是：

double beamAngle, sourceAngle, sourceAngleConfidence;
audioGenerator.GetRealProperty("beamAngle", beamAngle);
// read-only or read-write when beamAngleMode is manual
audioGenerator.GetRealProperty("sourceAngle", sourceAngle);
// read-only
audioGenerator.GetRealProperty("sourceAngleConfidence", sourceAngleConfidence);
// read-only