Merge pull request #127721 from tayaras/patch-4

Enhance documentation on optimal video count changes

Author: ShannonLeavitt

articles/communication-services/quickstarts/voice-video-calling/optimizing-video-placement.md

@@ -82,6 +82,29 @@ When there's a change in the optimal video count value, if the result indicates
 
 Conversely, if the optimal count decreases and is [less than the current number of videos on the page](../../resources/troubleshooting/voice-video-calling/video-issues/reaching-max-number-of-active-video-subscriptions.md), consider disposing of a video using the dispose method and updating the application layout accordingly.
 
+#### Optimal video count changed reason
+
+When the SDK adjusts the number of rendered video streams, developers can see why the change occurred. The `optimalVideoCountChanged` event includes a `reason` property, helping you adapt UI and troubleshoot quality issues.
+
+Supported reasons:
+- Bandwidth – Network limitations  
+- Performance – Device constraints  
+
+Examples:
+```javascript
+const ovcFeature = this.call.feature(Features.OptimalVideoCount);
+
+// Shows the optimalVideoCount value
+console.log(ovcFeature.optimalVideoCount);
+
+// shows the last reason for a change
+console.log(ovcFeature.lastOvcChangeReason); 
+
+// listener for getting updates on changes
+ovcFeature.on('optimalVideoCountChanged', () => {}); 
+```
+
+
 ### Things to consider when adding a 1080p or 720p video to a page.
 
 - You can place one 1080p incoming video with the rest smaller than 720p.
@@ -193,6 +216,7 @@ The following table illustrates how video resolution changes based on the number
 > [!NOTE]  
 > The public preview 1.37.1-beta.1 and greater of the calling WebJS SDK currently supports up to **25** incoming video streams for desktop browsers (5x5 grid).
 
+
 ## Conclusion
 
 To determine how many videos to place on a web page, you need to carefully consider resolution, device type, bandwidth, and user experience. Follow these guidelines and best practices to create web apps that not only look appealing but also function seamlessly, providing an optimal viewing experience for users across various devices and connection speeds.