Skip to content

Commit

Permalink
Merge branch 'milestone-48-vsdk-web-4-19-2' of https://github.com/Ago…
Browse files Browse the repository at this point in the history
  • Loading branch information
atovpeko committed Oct 20, 2023
2 parents adefa22 + 279b550 commit b31d7f7
Show file tree
Hide file tree
Showing 5 changed files with 45 additions and 17 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Integrate the virtual background extension, and implement the virtual background

```typescript
// Create a client object
var client = AgoraRTC.createClient({mode: "rtc", codec: "vp8"});
var client = AgoraRTC.createClient({mode: "rtc", codec: "vp9"});
// Create a VirtualBackgroundExtension instance
const extension = new VirtualBackgroundExtension();
// Check browser compatibility virtual background extension
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import AgoraRTC from "agora-rtc-sdk-ng";
import VirtualBackgroundExtension from "agora-extension-virtual-background";

// Create a client object
var client = AgoraRTC.createClient({mode: "rtc", codec: "vp8"});
var client = AgoraRTC.createClient({mode: "rtc", codec: "vp9"});
// Create a VirtualBackgroundExtension instance
const extension = new VirtualBackgroundExtension();
// Register the extension
Expand Down
2 changes: 1 addition & 1 deletion shared/media-pull/reference/_release-notes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ The changes for earlier releases include adding support for the following:
- Streaming encapsulation formats: FLV, MP4, MPEG-TS, Matroska (MKV), MP3.
- Playback scheduling. Set the start time of playing online media streams to schedule playback.
- Restricted access area. Specify the region where the online media stream is played in the request, to ensure the transmission quality of the media stream.
- On-demand stream loop playback.
- On-demand stream loop playback.
21 changes: 11 additions & 10 deletions shared/video-sdk/develop/_ensure-channel-quality.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -188,53 +188,54 @@ The recommended settings for these different scenarios are:
| 480p_8 | 848 × 480 | 15 | 610 |
| 480p_9 | 848 × 480 | 30 | 930 |
| 480p_10 | 640 × 480 | 10 | 400 |
| **540p (Default)**| **960 × 540** | **15** | **1100** |
| 540p | 960 × 540 | 15 | 1100 |
| 720p | 1280 × 720 | 15 | 1130 |
| 720p_1 | 1280 × 720 | 15 | 1130 |
| 720p_2 | 1280 × 720 | 30 | 2000 |
| 720p_3 | 1280 × 720 | 30 | 1710 |
| 720p_5 | 960 × 720 | 15 | 910 |
| 720p_6 | 960 × 720 | 30 | 1380 |
| 720p_auto | 1280 × 720 | 30 | 3000 |
| 1080p | 1920 × 1080 | 15 | 2080 |
| 1080p_1 | 1920 × 1080 | 15 | 2080 |
| 1080p_2 | 1920 × 1080 | 30 | 3000 |
| 1080p_3 | 1920 × 1080 | 30 | 3150 |
| 1080p_5 | 1920 × 1080 | 60 | 4780 |

<PlatformWrapper platform="android">
For more details, see <Link to="{{Global.API_REF_ANDROID_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_ANDROID_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="ios">
For more details, see <Link to="{{Global.API_REF_IOS_ROOT_RTC_KIT}}/agoravideoencoderconfiguration">AgoraVideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_IOS_ROOT_RTC_KIT}}/agoravideoencoderconfiguration">AgoraVideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="web">
For more details, see <Link to="{{Global.API_REF_WEB_ROOT}}/globals.html#videoencoderconfigurationpreset">VideoEncoderConfigurationPreset</Link>.
The default video profile is 480p_1. For more details, see <Link to="{{Global.API_REF_WEB_ROOT}}/globals.html#videoencoderconfigurationpreset">VideoEncoderConfigurationPreset</Link>.
</PlatformWrapper>

<PlatformWrapper platform="macos">
For more details, see <Link to="{{Global.API_REF_MACOS_ROOT_RTC_KIT}}/agoravideoencoderconfiguration">AgoraVideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_MACOS_ROOT_RTC_KIT}}/agoravideoencoderconfiguration">AgoraVideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="windows">
For more details, see <Link to="{{Global.API_REF_CPP_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_CPP_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="electron">
For more details, see <Link to="{{Global.API_REF_ELECTRON_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_ELECTRON_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="unity">
For more details, see <Link to="{{Global.API_REF_UNITY_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_UNITY_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="flutter">
For more details, see <Link to="{{Global.API_REF_FLUTTER_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_FLUTTER_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
</PlatformWrapper>

<PlatformWrapper platform="react-native">
For more details, see <Link to="{{Global.API_REF_RN_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
The default video profile is 540p. For more details, see <Link to="{{Global.API_REF_RN_ROOT}}/class_videoencoderconfiguration.html">VideoEncoderConfiguration</Link>.
</PlatformWrapper>

### Mainstream video profiles
Expand Down
35 changes: 31 additions & 4 deletions shared/video-sdk/reference/release-notes/web.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,33 @@ See [Supported platforms](../reference/supported-platforms).

See [Known issues](known-issues).

### v4.19.2

v4.19.2 was released on October 20, 2023.

#### Improvements

**VP9 codec (GA)**

This release advances VP9 from Beta to General Availability (GA) and introduces the following enhancements:

- Updated browser compatibility: VP9 now supports Safari 16.0 and later versions on both desktop and mobile platforms.
- Automatic fallback to VP8 for older browsers: If any user in a channel uses a browser version below the [specified compatibility threshold](#vp9-codec-beta), all VP9-encoded video streams in that channel will automatically transition to VP8.

Test results show that VP9 provides twice the quality of VP8 at equivalent bitrates.

**Dynamic resolution adjustment on Safari**

Safari has a known issue where it does not automatically reduce video encoding resolution under poor network conditions or reduced video frame rates, potentially leading to blurry video. To ensure user experience, this release adds the `"720p_auto"` preset to the video encoder configurations. This preset guarantees automatic adjustment of the video encoding resolution on Safari.

After upgrading to this version, if you are using a 720p video profile, Agora recommends switching to the `"720p_auto"` preset and setting the encoding format to `"vp9"` for optimal results.

#### API changes

**Added**

- `"720p_auto"` to `VideoEncoderConfigurationPreset`

### v4.19.1

v4.19.1 was released on October 11, 2023.
Expand Down Expand Up @@ -447,15 +474,15 @@ Agora enables channel hosts to control whether the audio streams being published

To enable this function, contact [[email protected]](mailto:[email protected]).

##### VP9 codec (Beta)
##### VP9 codec

Video SDK for Web v4.15.0 adds support for the VP9 codec in the following browsers:

| | Supported browsers<sup>①</sup> |
| ------- | ------------------------------------------------------------ |
| Desktop | <li>Chrome 65 or later</li><li>Firefox 69 or later</li><li>Edge 79 or later</li> |
| Android | <li>Chrome 68 or later</li><li>Wechat v8.0.6 or later </li><li>Other apps that use WKWebView: WebView v55.0.28883.91 or later</li> |
| iOS | N/A |
| Desktop | <li>Chrome 65 or later</li><li>Firefox 69 or later</li><li>Edge 79 or later</li> <li>Safari 16 or later</li>|
| Android | <li>Chrome 68 or later</li><li>Wechat v8.0.6 or later </li><li>Other apps that use WKWebView: WebView v65.0.3325.109 or later</li> |
| iOS | Safari 16 or later |

<div class="alert info">① To ensure the best user experience, best practice is to use the latest version of the browsers listed above.</div>

Expand Down

0 comments on commit b31d7f7

Please sign in to comment.