feat: option to disable video initially

This can be used to implement two buttons in the host apps:
- Start audio call
- Start video call

Author: WofWca

README.md

@@ -21,6 +21,10 @@ Commands are given to the app via URL hash:
 
 **IMPORTANT:** `PAYLOAD` **must** be base64 encoded (NOTE: you might still need to URL-encode the base64 string to be a valid URL hash) before passing it to the app in the URL hash.
 
+In order to start the app in audio-only mode initially,
+provide `noOutgoingVideoInitially` in the query (search) string
+of the initial URL, e.g. `/index.html?noOutgoingVideoInitially#startCall`.
+
 ## Contributing
 
 ### Installing Dependencies

src/App.tsx

@@ -20,8 +20,17 @@ export default function App() {
   const outVidRef = useRef<HTMLVideoElement | null>(null);
   const incVidRef = useRef<HTMLVideoElement | null>(null);
 
+  const enableVideoInitiallyRef = useRef<boolean | null>(null);
+  if (enableVideoInitiallyRef.current == null) {
+    enableVideoInitiallyRef.current = !location.search.includes(
+      "noOutgoingVideoInitially",
+    );
+  }
+  const enableVideoInitially = enableVideoInitiallyRef.current;
+
   const [isOutAudioEnabled, setIsOutAudioEnabled] = useState(true);
-  const [isOutVideoEnabled, setIsOutVideoEnabled] = useState(true);
+  const [isOutVideoEnabled, setIsOutVideoEnabled] =
+    useState(enableVideoInitially);
   const isOutAudioEnabledRef = useRef(isOutAudioEnabled);
   isOutAudioEnabledRef.current = isOutAudioEnabled;
   const isOutVideoEnabledRef = useRef(isOutVideoEnabled);