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

1. Use getControlSettings to make a request to get the current treble setting on the audio device

2. Use setControlSettings to make a request to adjust the treble

3. Check that the change has been applied successfully

Adjust bass

1. Use getControlSettings to make a request to get the current bass setting on the audio device

2. Use setControlSettings to make a request to adjust the bass

3. Check that the change has been applied successfully

Adjust treble

Step 1 - Create a command to get the current treble setting

1. Pass "v1/devices/commands/getControlSettings" in to the "request" property
2. Fill in requestId and clientId according to the request format guide
3. 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"
4. 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

1. Pass "v1/devices/commands/setControlSettings" in to the "request" property
2. Fill in requestId and clientId according to the request format guide
3. Add the property "speakerTrebleLevel" to the body property
4. Give "speakerTrebleLevel" a value between 0 and 100
5. 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

1. Pass "v1/devices/commands/getControlSettings" in to the "request" property
2. Fill in requestId and clientId according to the request format guide
3. 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"
4. 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

1. Pass "v1/devices/commands/setControlSettings" in to the "request" property
2. Fill in requestId and clientId according to the request format guide
3. Add the property "speakerBassLevel" to the body property
4. Give "speakerBassLevel" a value between 0 and 100
5. 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.