Emotiv 文档

emotiv

$\Huge{目录}$

0. 特别说明

• 库函数使用 C Style 的 struct 和 union

1. 数据字典

• 结构体 IInputSensorDescriptor_struct
  
  • 头文件 #include <Iedk.h>

• 结构体 profileVerInfo
  
  • 头文件 #include <EmotivCloudClient.h>

2. 头文件概览

3. 核心库(数据、宏及函数)

• 相关头文件
  
  • #include "IedkErrorCode.h"
  • #include "IEmoStateDLL.h"
  • #include "FacialExpressionDetection.h"
  • #include "MentalCommandDetection.h"

3.1 相关数据结构

参考: 数据字典

3.2 宏定义

#define EDK_API

3.3 Typedefs

3.4 枚举类型

• 直接参看emotiv-community-sdk

3.5 核心函数

• 执行过程

EmoEngineEventHandle eEvent =  IEE_EmoEngineEventCreate();
EmoStateHandle eState = IEE_EmoStateCreate();
unsigned int engineUserID = -1; // => UNSIGNED_INT_MAX
bool ready = false;
int state = 0;
/**
 * Insight的5个电极分别是：
 *         左眼AF3 右眼AF4
 * 左耳T7                   右耳T8
 *             后脑勺Pz
 *
 */
IEE_DataChannel_t = channelList[] = {IED_AF3, IED_AF4, IED_T7, IED_T8, IED_Pz };
if (IEE_EngineConnect() != EDK_OK) {
    std::cout << "Emotiv Driver start up failed!" << std::endl;
    return -1;
} else {
    std::cout << "Emotiv Driver start up success!" << std::endl;
}
while (true/*...*/) {
    state = IEE_EngineGetNextEvent(eEvent); // 获取下一个事件，保存至eEvent中
    if (state == EDK_OK) {
        IEE_Event_t eventType = IEE_EmoEngineEventGetType(eEvent);
        IEE_EmoEngineEventGetUserId(eEvent, &engineUserID);
        if (eventType == IEE_UserAdded) {
            std::cout << "User added" << std::endl;
            engineUserID = 0;
            IEE_FFTSetWindowingType(engineUserID, IEE_HAMMING);
            ready = true;
        }
        if (ready) {
            double alpha, low_beta, high_beta, gamma, theta;
            int channelCount = sizeof(channelList) / sizeof(channelList[0]); // or sizeof(channelList) / sizeof(IEE_DataChannel_t)
            for (int i = 0; i < channelCount; ++i) {
                int result = IEE_GetAverageBandPowers(engineUserID, channelList[i], &theta, &alpha, &low_beta, &high_beta, &gamma);
                if (result == EDK_OK) {
                    // handle the detect result of theta/alpha/beta/gamma =>
                }
            }
        }
    }
}
IEE_EngineDisconnect();
IEE_EmoStateFree(eState);
IEE_EmoEngineEventFree(eEvent);

3.5.1 函数索引

• 以下为简单索引

3.5.2 程序流程说明

参考 执行过程，核心执行过程如下

• 主程序执行前先用IEE_EngineConnect连接

• 连接成功后，进入事件循环

• 事件循环中，使用IEE_EngineGetNextEvent获取下一个事件，并处理

  • 若IEE_UserAdded事件来临，则通过IEE_FFTSetWindowingType设置Windowing类型
  • 每轮消息循环中均可使用IEE_GetAverageBandPowers等函数获取状态消息或其他信息并做响应