From 344f5bda697869513bf133279c09a0887777072a Mon Sep 17 00:00:00 2001
From: Azure CI <>
Date: Thu, 14 May 2020 20:48:16 +0000
Subject: [PATCH] docs(ci): Update protocol.md - 33b080b [skip ci]

---
 docs/generated/comments.json | 28 +++++++++++++++++++++-------
 docs/generated/protocol.md   | 10 ++++++----
 2 files changed, 27 insertions(+), 11 deletions(-)

diff --git a/docs/generated/comments.json b/docs/generated/comments.json
index dc7f68c2..6bc300a7 100644
--- a/docs/generated/comments.json
+++ b/docs/generated/comments.json
@@ -5642,11 +5642,14 @@
       },
       {
         "subheads": [],
-        "description": "Get the volume of the specified source.",
-        "param": "{String} `source` Source name.",
+        "description": "Get the volume of the specified source. Default response uses mul format, NOT SLIDER PERCENTAGE.",
+        "param": [
+          "{String} `source` Source name.",
+          "{boolean (optional)} `useDecibel` Output volume in decibels of attenuation instead of amplitude/mul."
+        ],
         "return": [
           "{String} `name` Source name.",
-          "{double} `volume` Volume of the source. Between `0.0` and `1.0`.",
+          "{double} `volume` Volume of the source. Between `0.0` and `1.0` if using mul, under `0.0` if using dB (since it is attenuating).",
           "{boolean} `muted` Indicates whether the source is muted."
         ],
         "api": "requests",
@@ -5662,7 +5665,7 @@
           {
             "type": "double",
             "name": "volume",
-            "description": "Volume of the source. Between `0.0` and `1.0`."
+            "description": "Volume of the source. Between `0.0` and `1.0` if using mul, under `0.0` if using dB (since it is attenuating)."
           },
           {
             "type": "boolean",
@@ -5675,6 +5678,11 @@
             "type": "String",
             "name": "source",
             "description": "Source name."
+          },
+          {
+            "type": "boolean (optional)",
+            "name": "useDecibel",
+            "description": "Output volume in decibels of attenuation instead of amplitude/mul."
           }
         ],
         "names": [
@@ -5705,10 +5713,11 @@
       },
       {
         "subheads": [],
-        "description": "Set the volume of the specified source.",
+        "description": "Set the volume of the specified source. Default request format uses mul, NOT SLIDER PERCENTAGE.",
         "param": [
           "{String} `source` Source name.",
-          "{double} `volume` Desired volume. Must be between `0.0` and `1.0`."
+          "{double} `volume` Desired volume. Must be between `0.0` and `1.0` for mul, and under 0.0 for dB. Note: OBS will interpret dB values under -100.0 as Inf.",
+          "{boolean (optional)} `useDecibel` Interperet `volume` data as decibels instead of amplitude/mul."
         ],
         "api": "requests",
         "name": "SetVolume",
@@ -5723,7 +5732,12 @@
           {
             "type": "double",
             "name": "volume",
-            "description": "Desired volume. Must be between `0.0` and `1.0`."
+            "description": "Desired volume. Must be between `0.0` and `1.0` for mul, and under 0.0 for dB. Note: OBS will interpret dB values under -100.0 as Inf."
+          },
+          {
+            "type": "boolean (optional)",
+            "name": "useDecibel",
+            "description": "Interperet `volume` data as decibels instead of amplitude/mul."
           }
         ],
         "names": [
diff --git a/docs/generated/protocol.md b/docs/generated/protocol.md
index 2f553495..08b8efe5 100644
--- a/docs/generated/protocol.md
+++ b/docs/generated/protocol.md
@@ -2267,13 +2267,14 @@ _No specified parameters._
 
 - Added in v4.0.0
 
-Get the volume of the specified source.
+Get the volume of the specified source. Default response uses mul format, NOT SLIDER PERCENTAGE.
 
 **Request Fields:**
 
 | Name | Type  | Description |
 | ---- | :---: | ------------|
 | `source` | _String_ | Source name. |
+| `useDecibel` | _boolean (optional)_ | Output volume in decibels of attenuation instead of amplitude/mul. |
 
 
 **Response Items:**
@@ -2281,7 +2282,7 @@ Get the volume of the specified source.
 | Name | Type  | Description |
 | ---- | :---: | ------------|
 | `name` | _String_ | Source name. |
-| `volume` | _double_ | Volume of the source. Between `0.0` and `1.0`. |
+| `volume` | _double_ | Volume of the source. Between `0.0` and `1.0` if using mul, under `0.0` if using dB (since it is attenuating). |
 | `muted` | _boolean_ | Indicates whether the source is muted. |
 
 
@@ -2292,14 +2293,15 @@ Get the volume of the specified source.
 
 - Added in v4.0.0
 
-Set the volume of the specified source.
+Set the volume of the specified source. Default request format uses mul, NOT SLIDER PERCENTAGE.
 
 **Request Fields:**
 
 | Name | Type  | Description |
 | ---- | :---: | ------------|
 | `source` | _String_ | Source name. |
-| `volume` | _double_ | Desired volume. Must be between `0.0` and `1.0`. |
+| `volume` | _double_ | Desired volume. Must be between `0.0` and `1.0` for mul, and under 0.0 for dB. Note: OBS will interpret dB values under -100.0 as Inf. |
+| `useDecibel` | _boolean (optional)_ | Interperet `volume` data as decibels instead of amplitude/mul. |
 
 
 **Response Items:**