[XMOVE自主设计的体感方案] XMove Studio管理系统(二)应用开发API简要介绍

简介:

一. XMove的开放式应用开发框架简介

  XMove4.0以开放式的结构满足扩展性的要求。所有无线协议,底层算法和控制逻辑全部上移到PC端。节点只根据接受的控制逻辑返回传感器数据。新的架构使得开发新应用非常方便。

  本节将主要介绍XMove应用开发API及其使用。

二. 注册新应用  

  我们将以开发“空中鼠标”应用为例,介绍开发应用的方法。

  空中鼠标是通过陀螺仪传感器采集的旋转数据,传递给PC机,在空中旋转节点即可控制PC鼠标的功能。由于需要鼠标左右键,因此最低节点需求是含键盘的节点。

  1.环境搭建

  在VS中新建C#类库工程,引用XFrmWork.XMove.Interface 基类库的dll文件。该文件包含了XMove的核心基类和抽象逻辑。若您曾经做过这步,可以跳过。添加功能时仅需在该工程中添加新的类即可。

  注意,需将该工程的dll输出路径修改为XMove应用插件文件夹XMovePlugin。这样就可以不用手动拷贝了。

  2. 继承基类

  XMove应用基类是AbstractApp,它提供基础的服务和接口。新应用从AbstractApp继承。

?
[XFrmWorkAttribute( "空中鼠标" , "IProgramWPF" , "利用陀螺仪实现的空中鼠标系统" , "/XFrmWork.XMove.Program;component/Images/空中鼠标.jpg" )]
public class SkyMouse : AbstractApp
{
     //在此处添加代码逻辑
}

  为了能被XFrmWork插件搜索器搜索到,需要添加XFrmWorkAttribute插件标记。四个参数分别是: APP名称,接口约束(应用固定为IProgramWPF), 说明介绍,和图片资源地址(方便主框架显示应用Logo)、

  3. 查看效果

  生成工程,运行XMove主程序,如下图所示,XFrmWork已经成功加载该应用。

 

三.节点映射和配置节点工作状态

 1. 节点映射配置

   要想获取节点传递来的信息,首先要配置应用程序节点映射。节点映射一般在默认情况下给出映射到哪个节点组的哪个节点,并给出其名称和最低节点功能需求。

  在应用程序启动时,首先尝试读取硬盘中存储的节点映射表,否则尝试重建默认映射表。因此必须重写重建函数:

  

复制代码
   public override void RebuildNodeRelation()
        {
            myProgramRoutedNode = new NodeRoutedCollection();
            myProgramRoutedNode.Add(new ProgramNodeRegeistration()
            {
                Name = "手持设备",
                GroupID = 0,
                SelectedID = NodeID.LeftHandNode,
                MinRequiredNodeType= XMoveStaticsHelper.QueryAbstractNodeString(typeof(XNodeHID))});
        }
复制代码

  如上案例所示,只增加一个节点,名称是手持设备,默认组别为0,组内ID是左手节点。最低要求是XNodeHID(包含键盘的MEMS节点)

  若您允许用户在应用中修改映射表的表项数量,需要重写以下属性:

  由于空中鼠标只需一个节点,因此不需要改变节点映射项数量,return false. 默认是return false的。此时,用户在运行时修改数量的按钮将不可用。

        public override bool isMountChangedeable
        {
            get { return false; }
        }

 

   基类已经将从外部读取映射表,和结束程序时存储映射表的功能实现,作为开发者的您可以不关心这些问题。您只需关心重建函数和isMountChangedeable属性。

  2. 配置节点工作状态

  为了尽可能降低节点工作功耗,应该给出应用程序所需的节点刷新速率,是否需要陀螺仪等属性。节点工作状态的描述类为:

  其中NodeWorkMode类描述了节点当前的工作状态,而NodeControlledWorkMode类从NodeWorkMode继承,描述当前对该节点所有工作状态需求的汇总。

  NodeControlledWorkMode类会自动汇总所有应用对该节点需求,求出能满足所有应用的最低需求。从而在应用发生改变时,控制节点切换到相应模式。

  public override void ConfigNodeWorkMode()
        {
            LeftHandXNodeHID.neededWorkMode.SetWorkMode(this,true, NodeFreshSpeed.一秒32次);
        }

 

  其中函数的定义为:

   public  void SetWorkMode(IProgramWPF program,bool gyroEnable, NodeFreshSpeed speed)
        {
            myNeededList.Add(program, new Tuple<bool, NodeFreshSpeed>(gyroEnable, speed));
            RefreshData();
        }

 

  参数分别为该程序的引用,是否能开启陀螺仪和刷新速度。  由于陀螺仪是传感器中的耗电大户,因此应该在不需要的情形下尽可能关闭之。

四.获取传感器数据

  应用一般有两种类型:

  •   隔一段时间获取传感器数据,实现刷新,但并不关心数据是否是最新的
  • 只有当新数据到来时才会触发应用事件。

   我们分别将将它们称作定时器型应用和事件型应用。对于空中鼠标而言,应属于事件型应用。

  首先必须获得映射表定义的节点的引用:

     LeftHandXNodeHID = XNodeGroupManager.Instance[myProgramRoutedNode[0]] as XNodeHID;

  XNodeGroupManager是节点管理器类,通过单例模式提供方便的访问权限,索引器中,可以按上述格式,获取节点引用。

 1. 定时器型应用

  定时器型应用不关心数据是否是最新的,但需要稳定的定时实现刷新。要想实现定时刷新,需要重写以下字段:

复制代码
   public override int ProcessPerSecond
        {
            get
            {
                return 25;
            }
        }
      
复制代码

 

  应用程序管理器会为重写该字段的每个应用提供定时器支持,在点击开启按钮后,会自动启动定时器,按下停止后关闭。应用程序可不关心其具体实现。

  至于在定时到来时要处理的逻辑,可以通过重写DataProcess()函数:

复制代码
 public override bool DataProcess()
        {
    
                VirtualKey.VKMouse(1, (int)(-LeftHandXNodeHID.GyroZ / 20), (int)(LeftHandXNodeHID.GyroY / 20), 0, 0);
            switch (LeftHandXNodeHID.thisKeyChanged)
            {
                case KeyBoardChanged.KEYUP_DOWN:  //左键

                    VirtualKey.VKMouse(0x0002, 0, 0, 0, 0);  //按下

                    break;
                case KeyBoardChanged.KEYUP_UP:
                    VirtualKey.VKMouse(0x0004, 0, 0, 0, 0);  //弹起
                    break;

                case KeyBoardChanged.KEYDOWN_DOWN:  //右键

                    VirtualKey.VKMouse(0x0008, 0, 0, 0, 0);  //按下

                    break;
                case KeyBoardChanged.KEYDOWN_UP:  //右键
                    VirtualKey.VKMouse(0x0010, 0, 0, 0, 0);  //弹起
                    break;
                case KeyBoardChanged.KEYLEFT_DOWN:  //滚轮移动
                    VirtualKey.VKMouse(0x0800, 0, 0, -(int)(LeftHandXNodeHID.GyroX), 0);  //
                    break;
    }
                return true;
             
        }
复制代码

 

    值得注意的是,LeftHandXNodeHID是该类的节点引用持有者。这样,系统会在每隔1/25秒执行该函数。

 2. 事件型应用

   另外一种类型是事件型应用,它对处理性能的要求更低,也更灵活。应用应该通过事件的方式订阅节点管理器发出的通知:如节点获取新数据,建立新连接或断开连接等。

  要想配置成事件型应用,您需要将ProcessPerSecond属性中返回值改为0,这样系统就不会提供定时器了。

  对于空中鼠标应用,可以只关心节点传递来的新数据通知。在开启时,需要将处理方法挂接在该事件上,如下程序所示:

复制代码
   public override bool InitProcess()
        {

          
            LeftHandXNodeHID = XNodeGroupManager.Instance[myProgramRoutedNode[0]] as XNodeHID;
            LeftHandXNodeHID.OnXNodeEvent += LeftHandXNodeHID_OnProgramEvent;
            //除此之外,您可以添加其他初始化的函数
            return true;
        }
复制代码

 

  关闭应用时,将该事件取消挂接:  

  public override bool CloseProcess()
        {
            LeftHandXNodeHID.OnXNodeEvent -= LeftHandXNodeHID_OnProgramEvent;
            return true;
        }

  LeftHandXNodeHID_OnProgramEvent是处理事件,其功能与上述DataProcess()描述完全一致,此处从略。

  3. 混合型应用

  若您同时需要定时器和事件,可以将ProcessPerSecond设置成需要的值,同时挂载事件,与1,2描述一致,此处从略。

五. 开发有UI控件的应用

  在很多情形下,您可能需要开发带UI控件的应用。此时的开发要比一般情形复杂。具体实现方法和您的具体设计有关。目前仅提供WPF内置的UserControl控件的支持。

  1. 使用MVVM结构开发

  若您对MVVM结构很熟悉,则推荐采用这种开发方式,此时,需要让您开发的类实现IView接口:

  我们假设您对MVVM模式已经很熟悉,需要另外设计ViewModel,该类中是DynIdentityTrainnerUI, 在构造函数中,实现数据上下文绑定。

复制代码
   public class DynIdentityTrainner : AbstractApp, IView
    {
      DynIdentityTrainner()
{
 myDynIdentityTrainnerUI.DataContext = this;   //实现绑定
}

  DynIdentityTrainnerUI myDynIdentityTrainnerUI = new DynIdentityTrainnerUI();
        public UserControl thisUserControl  //IView接口成员:返回要显示的UI控件
        {
            get { return myDynIdentityTrainnerUI; }
        }

        public FrmState thisFrmState  //IView接口成员:返回要放置的位置
        {
            get { return FrmState.Large; }  
        }
}
复制代码

 

  2. 不使用MVVM开发

  若您对MVVM不熟悉,通常的解决办法是从UserControl类继承。但是C#只支持单继承,通常的办法是实现XMove基本应用的所有接口,这对于开发者是不合适的,因此我提供了一个UI类,解决了这一问题:  

 public class AbstractUIApp : UserControl, IProgramWPF, IProgramNodeChangeable, IView, IRelationComputeable
    {
     //实现代码
    }

 

  在开发时,您需要从AbstractUIApp类继承,此时可获得界面设计器的支持,其他的开发方式和上述一致,此处不赘述。

六. 其他注意点

  1.可能要重写的其他函数

  除了以上可能要修改的属性和重写函数外,还有两个函数可能需要重写:

     LoadMainResource函数在用户将其拖到应用列表时执行,若加载大型资源时必须重写该函数,而不是定义在InitProcess函数中,因为用户随时都可能开启或关闭程序,不应该在此函数中过分耗时。

  例如空中鼠标,它需要在第一次初始化时加载SVM识别模型。用于手势识别。

复制代码
 public override bool LoadMainResource()
        {
             mySVMMethod = new SVMMethod();
            mySVMMethod.LoadSVMModel(PublicName);

            return true;
        }
复制代码

   除此之外,还有对应的释放函数。和初始化需要的注意点一致:

  

 public override bool ReleaseMainResource()
        {
            //释放所需的非托管资源
        }

   2. 两个辅助外部管理器

  一些管理型应用,不仅需要获取节点的数据,还需要知悉整个系统的工作状态,此时就需要获得一些扩展功能。

  系统提供在基类中提供了两个服务者,解决了以上问题:  

    public AbstractCommManager thisCommManager { get; set; }
        
     public IProgramManager thisProgramManager { get; set; }

      分别是通信管理器接口和程序管理器接口,它封装了和限制了应用对管理器的控制权限,提供了可读的一些有用信息。

  例如,在thisProgramManager的帮助下,应用可以开启或关闭另外一个应用,可以在界面上添加或删除新的UI组件,

复制代码
  /// <summary>
   /// 应用程序管理器
   /// </summary>
    public interface IProgramManager
    {
        bool BeginOneProcess(IProgramWPF rc);
        bool StopOneProcess(IProgramWPF rc);
        void AddUserControl(UserControl value, FrmState thisState, string title);
        void RemoveUserControl(UserControl value);
        IEnumerable<NodeEnumKeyPair> GetAllEnumerable { get; }
        IEnumerable<IProgramWPF> GetActivePrograms { get; }
    }
复制代码

     与其类似的是,可以开启或关闭通信方法,或获取已开启通信方法的枚举等。

  3. 安全性

  由于系统使用和开发环境都是基于专业用户的,因此以开放的精神,API提供的接口的权限都达到甚至超过了实际应用的最大需求。在开发应用时,您应该考虑只读取数据,而不非法写入或修改核心状态数据,这可能会导致系统崩溃或出现不可预见的问题。

  4. 其他API

  XMove开发环境内置了XFrmWork的全部功能集合,同时有.NET FrameWork作为支持,您所需的大部分函数和功能类都可以在其中找到,这包括网络通信,数据库,图形UI等。您可以参考详细开发文档,此处不进行详细描述。

  5.发布

  您可以将您的工程编译为dll,提供给用户。在目前框架下,无法实现自动升级,因此需要手动拷贝。未来框架会加入自动升级功能。

七. 总结

  本文较详细的介绍了在XMove框架下开发新应用的方法和注意事项。目前XMove框架已经支持多达20多种应用,涉及节点管理,人机交互,虚拟现实等应用,我会在后续文章中继续介绍。  

  若您感兴趣,欢迎联系我  buptzym@bupt.edu.cn

  

 


作者:热情的沙漠
出处:http://www.cnblogs.com/buptzym/
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

标签: XMove, .NET

本文转自FerventDesert博客园博客,原文链接:http://www.cnblogs.com/buptzym/archive/2012/07/14/2591097.html,如需转载请自行联系原作者
目录
相关文章
|
7月前
|
JavaScript API
【vue实战项目】通用管理系统:api封装、404页
【vue实战项目】通用管理系统:api封装、404页
77 3
|
6月前
|
JavaScript 前端开发 测试技术
【vue实战项目】通用管理系统:api封装、404页
【vue实战项目】通用管理系统:api封装、404页
44 3
|
5月前
|
开发框架 前端开发 JavaScript
循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理
循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理
|
5月前
|
存储 开发框架 前端开发
循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用
循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用
|
5月前
|
人工智能 自然语言处理 算法
开放式API在AI应用开发中的革命性角色
【7月更文第21天】随着人工智能技术的飞速发展,开放式API(Application Programming Interfaces)正逐渐成为连接技术与创新、加速AI应用开发的关键桥梁。这些API允许开发者轻松访问预先训练好的模型和复杂算法,无需从零开始构建基础架构,从而极大地降低了AI应用的开发门槛,促进了技术民主化。本文将探讨开放式API如何在AI领域引发革命性变化,通过实际案例和代码示例展现其强大功能。
130 2
|
4月前
|
开发框架 .NET API
分享一个 ASP.NET Web Api 上传和读取 Excel的方案
分享一个 ASP.NET Web Api 上传和读取 Excel的方案
130 0
|
7月前
|
人工智能 API 开发者
【AI大模型应用开发】0.2 智谱AI API接入详细步骤和简单应用
【AI大模型应用开发】0.2 智谱AI API接入详细步骤和简单应用
1022 0
|
7月前
|
人工智能 API Python
【AI大模型应用开发】1.1 Prompt Engineering(提示词工程)- 用OpenAI API实战,优化方法论总结
【AI大模型应用开发】1.1 Prompt Engineering(提示词工程)- 用OpenAI API实战,优化方法论总结
355 0
|
7月前
|
缓存 监控 测试技术
ERP系统对接方案与API接口封装系列(高并发)
企业资源规划(ERP)系统是现代企业管理的核心,它集成了企业内部的各个部门和业务流程。为了实现ERP系统与其他外部系统或应用程序之间的数据交换和协作,需要对接方案。API(应用程序编程接口)是实现系统对接的常用方法之一。
|
安全 API 数据库
一款支持API文档编辑功能的WIKI文档管理系统
zyplayer-doc是一款现代化的适合团队和个人使用的WIKI文档管理工具,同时还包含数据库文档、Api接口文档
670 0