做好充分准备,迎接英特尔® 实感™ SDK 通用 Windows* 平台应用

简介

万众期待的英特尔® 实感™ SDK 支持开发通用 Windows* 平台 (UWP) 应用的特性终于被引入 SDK R5 (v7),本文将帮助您快速入门。 R4 版文档率先介绍了 UWP 界面和方法。R5 目前可提供所需的软件组件、示例和文档,供大家开发使用英特尔® 实感™ 摄像头 (SR300) 的 UWP 应用。

文章英特尔® 实感™ SDK R5 (v7) 新特性表示,SR300 摄像头将于 2016 年第 1 季度开始接受预订,并将在 2016 年集成至指定的基于英特尔的系统。 由于最终用户目前还无法购买 SR300,本文将重点介绍为该摄像头作准备时需要注意的事项。

入门所需的组件/strong>

运行 Microsoft Window 10 RTM 的笔记本电脑或 PC
带有 Microsoft Windows 10 开发人员工具的 Microsoft Visual Studio* 2015
英特尔实感摄像头 (SR300)(2016 年第 1 季度接受预订)
英特尔实感 SDK R5 (v7)
SR300 DCM 3.0 Gold(仅通过 Windows 更新获取)

SDK 适用范围与局限性

SDK 支持使用 C# 和 XAML 开发面向 Windows 10 的 UWP 应用。
就 UWP 应用而言,SDK 仅支持原始色彩和景深流处理,以及斑点追踪算法。 其他特定于 UWP 的算法目前正在开发。
UWP 应用必须以静态的形式纳入 SDK 运行时文件,因此 SDK 版本在开发阶段予以确定。
C# UWP 不明确展示会话界面。
摄像头坐标系统与 UWP 应用稍有不同,请阅读 SDK 手册,了解详情。
不能改变 UWP 应用中的坐标系统。
如需映射 UWP 应用中色彩与景深流之间的坐标,请使用 Windows.Devices.Perception.PerceptionDepthCorrelatedCoordinateMapper 界面。
在 SDK 手册中,(UWP) 标记表示特定于 UWP 的界面或方法。 (+UWP) 标记强调 UWP 界面同其他语言界面一起构成了函数的一部分。

Windows Desktop 应用示例

安装 DCM 和 SDK 后,重启计算机,然后通过运行英特尔实感 SDK 示例浏览器提供的其中一个示例,确保摄像头操作正确。

点击屏幕左下角的 Windows 10 Start 按钮。

选择 All Apps,之后滚动至 Intel RealSense SDK 文件夹(图 1)。

图 1. Windows 开始菜单

查找并运行 Intel RealSense SDK Sample Browser。 在 SDK Sample Browser 窗口(图 2)中,大家可以看到一个标有 “SR300 Samples” 的选项卡,它包含所有 Windows Desktop 示例应用(比如,以 Windows Desktop 模式运行的代码示例,不像 UWP 应用)。 大家应该熟悉这些示例,以了解 SR300 摄像头的全部功能。

图 2. SDK 示例浏览器

UWP 组件

英特尔实感 SDK 提供的 UWP 软件组件位于 C:\Program Files (x86)\Intel\RSSDK\UWP。 (注:它为默认安装路径;大家的文件路径会因 SDK 安装方式而有所不同。) 组件位于 \UWP 项下的以下文件夹中:

\ExtensionSDKs – 包含 UWP 应用将要参考的 DLL。
\Samples – 包含 DF_BlobViewer_UWP_CS 和 DF_StreamViewer_UWP_CS 代码示例。

从头创建 UWP 项目

如果第一次接触 UWP 应用开发,首先需要对如何从头创建 UWP 项目有基本的了解。 Microsoft 网站将提供信息量较大的 C#/XAML “Hello, world” 教程。

该教程为学习如何创建面向 UWP 和 Windows 10 的简单应用提供了一个良好的开端。 学习完 “Hello, world” 教程之后,运行新的 UWP 应用,类似于图 3 所示的屏幕。

图 3. Hello, world! UWP 应用

以 Debug 模式运行时,大家可能会注意应用左上角出现了一个黑色的帧计数器。 如果不想显示该计数器,可以在 App.xaml.cs 中查找以下代码:

01 #if DEBUG
02
03 if (System.Diagnostics.Debugger.IsAttached)
04
05 {
06
07 this.DebugSettings.EnableFrameRateCounter = true;
08
09 }
10
11 #endif

可以将属性设置为 false:
this.DebugSettings.EnableFrameRateCounter = false;

或简单添加注释这一行:
// this.DebugSettings.EnableFrameRateCounter = true;

配置适用于英特尔® 实感™ 摄像头的开发环境

如欲启用面向英特尔实感摄像头的应用,请完成以下操作:

启用应用清单 (App Manifest) 中功能 (Capabilities) 下方的 Webcam。
向英特尔实感 SDK 库添加参考。
在 Solution Explorer 中,双击 Package.appxmanifest,然后单击 Capabilities 选项卡。

查找并选中 Webcam 复选框,如图 4 所示。

图 4. Package.appxmanifest

接下来需要参考英特尔® 实感™ SDK 库:

Intel.RealSense – 这个库包含 SDK 基础实例的实施,比如算法管理和对摄像头的数据进行流处理。
Intel.RealSense.Blob – 这个库包含 SDK Blob Tracking 模块的实施。
在 Solution Explorer 中右击 References,然后选择 Add References… 以打开 Reference Manager 窗口。

单击 Browse 按钮,并导航至包含 Intel.RealSense.winmd 和 Intel.RealSense.Blob.winmd 的文件夹。 (元数据文件位于 C:\Program Files (x86)\Intel\RSSDK\UWP\ExtensionSDKs\ 下方。)

单击 Add 按钮。 库将显示在 Solution Explorer 中 References 的下方。

了解 UWP 示例

如欲了解更多关于如何将英特尔实感 SDK 功能集成至应用的信息,请打开并构建 SDK 提供的两个示例项目:

DF_BlobViewer_UWP_CS
DF_StreamViewer_UWP_CS
注: 之前介绍的 SDK 示例浏览器应用不提供这些示例。 它们位于 C:\Program Files (x86)\Intel\RSSDK\UWP\Samples 的下方,应拷贝至任意可写目录中,以借助 Visual Studio 2015 构建这些示例。

总结

本文简要介绍了如何开发集成了英特尔实感 SDK 的 UWP 应用。

文章来源:
英特尔开发人员专区