requestAccess
When your application calls this method for the first time, EMOTIV Launcher displays a message to approve your application.
You can call this API many times, but EMOTIV Launcher will prompt the user only once.
If the user has already approved your application, then this API does nothing.
Almost all the methods of the API require that your application was approved in EMOTIV Launcher. These methods will return an error if your application wasn't approved.
Any application that connects to Cortex must call this API to request approval from the user through EMOTIV Launcher.
Most of the methods of the API will fail if the user didn't approve your application.
Name | Type | Required | Description |
clientId | string | yes | The client id of your Cortex application |
clientSecret | string | yes | The client secret of your Cortex application |
The result is an object containing a boolean value "accessGranted" and a message.
Name | Type | Description |
accessGranted | boolean | True, if the user has already approved your application
False, if the user declined your application, or didn't approve it yet |
message | string | |
If accessGranted is false, then your application should ask the user to check EMOTIV Launcher and approve your application. Then you should wait for a while and call this API again.
If accessGranted is true, then no action is required.
Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "requestAccess",
"params": {
"clientId": "xxx",
"clientSecret": "xxx"
}
}
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"accessGranted":true,
"message":"The User has granted access right to this application."
}
}
Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "requestAccess",
"params": {
"clientId": "xxx",
"clientSecret": "xxx"
}
}
{
"id": 1,
"jsonrpc": "2.0",
"result": {
"accessGranted":false,
"message":"The User has not granted access right to this application. Please use Emotiv App to proceed."
}
}
Last modified 1yr ago