Adjust treble and bass
This tutorial shows how to adjust the treble and bass levels for Nureva® HDL310 and HDL410 devices over the local network.
Overview
Adjust treble
-
Use getControlSettings to make a request to get the current treble setting on the audio device
-
Use setControlSettings to make a request to adjust the treble
-
Check that the change has been applied successfully
Adjust bass
-
Use getControlSettings to make a request to get the current bass setting on the audio device
-
Use setControlSettings to make a request to adjust the bass
-
Check that the change has been applied successfully
Adjust treble
Step 1 - Create a command to get the current treble setting
- Pass "v1/devices/commands/getControlSettings" in to the "request" property
- Fill in
requestId
andclientId
according to the request format guide - Add the property "attributes" to the body property
- The attribute property is a list of attributes that will be returned in the response
- Add "speakerTrebleLevel"
- Send the request
The example request below will retrieve treble only.
{
"request": "v1/devices/commands/getControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "Extron",
"body": {
"attributes": ["speakerTrebleLevel"]
}
}
The example response below shows that treble is currently set to 14.
{
"request": "v1/devices/commands/getControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "Extron",
"body": {
"speakerTrebleLevel": 14
}
}
Step 2 - Create a command to adjust the treble
- Pass "v1/devices/commands/setControlSettings" in to the "request" property
- Fill in
requestId
andclientId
according to the request format guide - Add the property "speakerTrebleLevel" to the body property
- Give "speakerTrebleLevel" a value between 0 and 100
- Send the request
The example request below will set treble only.
{
"request": "v1/devices/commands/setControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "test",
"body": {
"speakerTrebleLevel": 12
}
}
Step 3 - Check that the change has been applied successfully
- Use the requestId to identify the response associated with your request. The requestId in the request and response should match up.
- If the request was successful, the request, requestId and clientId will be echoed back as a response
- If the request was unsuccessful, the request, requestId and clientId will be echoed back along with an error property, which will include details about the error
The example below indicates that the change was successfully applied.
{
"request": "v1/devices/commands/setControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "test"
}
Adjust bass
Step 1 - Create a command to get the current bass setting
- Pass "v1/devices/commands/getControlSettings" in to the "request" property
- Fill in
requestId
andclientId
according to the request format guide - Add the property "attributes" to the body property
- The attribute property is a list of attributes that will be returned in the response
- Add "speakerBassLevel"
- Send the request
The example request below will retrieve bass only.
{
"request": "v1/devices/commands/getControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "Extron",
"body": {
"attributes": ["speakerBassLevel"]
}
}
The example response below shows that bass is currently set to 42.
{
"request": "v1/devices/commands/getControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "Extron",
"body": {
"speakerBassLevel": 42
}
}
Step 2 - Create a command to adjust the bass
- Pass "v1/devices/commands/setControlSettings" in to the "request" property
- Fill in
requestId
andclientId
according to the request format guide - Add the property "speakerBassLevel" to the body property
- Give "speakerBassLevel" a value between 0 and 100
- Send the request
The example request below will set bass only.
{
"request": "v1/devices/commands/setControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "test",
"body": {
"speakerBassLevel": 59
}
}
Step 3 - Check that the change has been applied successfully
- Use the requestId to identify the response associated with your request. The requestId in the request and response should match up.
- If the request was successful, the request, requestId and clientId will be echoed back as a response
- If the request was unsuccessful, the request, requestId and clientId will be echoed back along with an error property, which will include details about the error
The example below indicates that the change was successfully applied
{
"request": "v1/devices/commands/setControlSettings",
"requestId": "3abe203s-42b7-4b0b-9awaf-5c381793a192",
"clientId": "test"
}
Tutorial complete!
You now know how to view and make changes to the treble and bass settings.
Updated 3 months ago