使用加速计

2025-06-10

了解如何使用加速计响应用户移动。

重要的应用程序接口（API）

先决条件

应熟悉可扩展应用程序标记语言（XAML）、Microsoft Visual C# 和事件。

正在使用的设备或模拟器必须支持加速计。

创建简单的加速计应用

简单的游戏应用依赖于单个传感器（加速计）作为输入设备。这些应用通常只使用一个或两个轴进行输入;但它们也可能使用摇动事件作为另一个输入源。

注释

有关更完整的实现，请参阅加速计示例。

说明书

创建一个新项目，从 Visual C# 项目模板中选择 空白应用程序（通用 Windows）。
打开项目的MainPage.xaml.cs文件，并将现有代码替换为以下内容。

    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;

    // Required to support the core dispatcher and the accelerometer

    using Windows.UI.Core;
    using Windows.Devices.Sensors;

    namespace App1
    {

        public sealed partial class MainPage : Page
        {
            // Sensor and dispatcher variables
            private Accelerometer _accelerometer;

            // This event handler writes the current accelerometer reading to
            // the three acceleration text blocks on the app' s main page.

            private async void ReadingChanged(object sender, AccelerometerReadingChangedEventArgs e)
            {
                await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
                {
                    AccelerometerReading reading = e.Reading;
                    txtXAxis.Text = String.Format("{0,5:0.00}", reading.AccelerationX);
                    txtYAxis.Text = String.Format("{0,5:0.00}", reading.AccelerationY);
                    txtZAxis.Text = String.Format("{0,5:0.00}", reading.AccelerationZ);

                });
            }

            public MainPage()
            {
                this.InitializeComponent();
                _accelerometer = Accelerometer.GetDefault();

                if (_accelerometer != null)
                {
                    // Establish the report interval
                    uint minReportInterval = _accelerometer.MinimumReportInterval;
                    uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
                    _accelerometer.ReportInterval = reportInterval;

                    // Assign an event handler for the reading-changed event
                    _accelerometer.ReadingChanged += new TypedEventHandler<Accelerometer, AccelerometerReadingChangedEventArgs>(ReadingChanged);
                }
            }
        }
    }

需要用你为项目指定的名称重命名前一个代码片段中的命名空间。例如，如果您创建了一个名为 AccelerometerCS的项目，您需要将 namespace App1 替换为 namespace AccelerometerCS。

打开文件 MainPage.xaml，并将原始内容替换为以下 XML。

        <Page
        x:Class="App1.MainPage"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="using:App1"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d">

        <Grid x:Name="LayoutRoot" Background="#FF0C0C0C">
            <TextBlock HorizontalAlignment="Left" Height="25" Margin="8,20,0,0" TextWrapping="Wrap" Text="X-axis:" VerticalAlignment="Top" Width="62" Foreground="#FFEDE6E6"/>
            <TextBlock HorizontalAlignment="Left" Height="27" Margin="8,49,0,0" TextWrapping="Wrap" Text="Y-axis:" VerticalAlignment="Top" Width="62" Foreground="#FFF5F2F2"/>
            <TextBlock HorizontalAlignment="Left" Height="23" Margin="8,80,0,0" TextWrapping="Wrap" Text="Z-axis:" VerticalAlignment="Top" Width="62" Foreground="#FFF6F0F0"/>
            <TextBlock x:Name="txtXAxis" HorizontalAlignment="Left" Height="15" Margin="70,16,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="61" Foreground="#FFF2F2F2"/>
            <TextBlock x:Name="txtYAxis" HorizontalAlignment="Left" Height="15" Margin="70,49,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="53" Foreground="#FFF2EEEE"/>
            <TextBlock x:Name="txtZAxis" HorizontalAlignment="Left" Height="15" Margin="70,80,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="53" Foreground="#FFFFF8F8"/>

        </Grid>
    </Page>

需要将上一代码段中类名的第一部分替换为应用的命名空间。例如，如果您创建了一个名为 AccelerometerCS的项目，您需要将 x:Class="App1.MainPage" 替换为 x:Class="AccelerometerCS.MainPage"。还应将 xmlns:local="using:App1" 替换为 xmlns:local="using:AccelerometerCS"。

按 F5 或选择调试>启动调试 生成、部署和运行应用。

应用运行后，可以通过移动设备或使用仿真器工具来更改加速计值。

返回到 Visual Studio，按 Shift+F5 或选择“调试”“停止调试”> 来结束应用程序。

说明

前面的示例演示了在应用中集成加速计输入所需的代码很少。

应用在 mainPage 方法中与默认加速计建立连接。

_accelerometer = Accelerometer.GetDefault();

应用程序在 MainPage 方法中建立报告间隔。此代码检索设备支持的最小间隔，并将其与请求的间隔 16 毫秒（大约为 60-Hz 刷新率）进行比较。如果支持的最小间隔大于请求的间隔，则代码会将该值设置为最小值。否则，它会将值设置为请求的间隔。

uint minReportInterval = _accelerometer.MinimumReportInterval;
uint reportInterval = minReportInterval > 16 ? minReportInterval : 16;
_accelerometer.ReportInterval = reportInterval;

新的加速计数据是在 ReadingChanged 方法中捕获的。传感器驱动程序每次从传感器接收新数据时，都会使用此事件处理程序将值传递给应用。应用在以下行中注册此事件处理程序。

_accelerometer.ReadingChanged += new TypedEventHandler<Accelerometer,
AccelerometerReadingChangedEventArgs>(ReadingChanged);

这些新值将写入项目 XAML 中的 TextBlock 标签。

<TextBlock x:Name="txtXAxis" HorizontalAlignment="Left" Height="15" Margin="70,16,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="61" Foreground="#FFF2F2F2"/>
 <TextBlock x:Name="txtYAxis" HorizontalAlignment="Left" Height="15" Margin="70,49,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="53" Foreground="#FFF2EEEE"/>
 <TextBlock x:Name="txtZAxis" HorizontalAlignment="Left" Height="15" Margin="70,80,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="53" Foreground="#FFFFF8F8"/>

通过

使用加速计

先决条件

创建简单的加速计应用

说明书

说明

反馈

其他资源