agora-electron-sdk 4.5.2-dev.2 → 4.5.3-build.1-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/CHANGELOG.md +38 -7
  2. package/README.md +6 -3
  3. package/js/AgoraSdk.js +2 -12
  4. package/js/Decoder/index.js +1 -1
  5. package/js/Private/AgoraBase.js +829 -674
  6. package/js/Private/AgoraMediaBase.js +154 -151
  7. package/js/Private/AgoraMediaPlayerTypes.js +58 -54
  8. package/js/Private/IAgoraLog.js +13 -13
  9. package/js/Private/IAgoraMediaEngine.js +4 -4
  10. package/js/Private/IAgoraMediaPlayer.js +2 -2
  11. package/js/Private/IAgoraMusicContentCenter.js +1 -1
  12. package/js/Private/IAgoraRhythmPlayer.js +13 -13
  13. package/js/Private/IAgoraRtcEngine.js +150 -94
  14. package/js/Private/IAgoraRtcEngineEx.js +3 -3
  15. package/js/Private/IAgoraSpatialAudio.js +4 -4
  16. package/js/Private/IAudioDeviceManager.js +2 -2
  17. package/js/Private/impl/IAgoraMediaPlayerImpl.js +10 -0
  18. package/js/Private/impl/IAgoraRtcEngineExImpl.js +74 -0
  19. package/js/Private/impl/IAgoraRtcEngineImpl.js +239 -5
  20. package/js/Private/internal/AgoraH265TranscoderInternal.js +3 -5
  21. package/js/Private/internal/IrisApiEngine.js +103 -1
  22. package/js/Private/internal/MediaEngineInternal.js +3 -5
  23. package/js/Private/internal/MediaPlayerInternal.js +3 -5
  24. package/js/Private/internal/MediaRecorderInternal.js +5 -6
  25. package/js/Private/internal/MusicContentCenterInternal.js +3 -5
  26. package/js/Private/internal/RtcEngineExInternal.js +102 -9
  27. package/js/Private/internal/VideoEffectObjectInternal.js +14 -0
  28. package/js/Private/ti/IAgoraRtcEngine-ti.js +2 -0
  29. package/js/Renderer/AgoraView.js +19 -2
  30. package/js/Renderer/IRenderer.js +7 -4
  31. package/js/Renderer/IRendererCache.js +17 -1
  32. package/js/Renderer/RendererCache.js +151 -14
  33. package/js/Renderer/RendererManager.js +13 -64
  34. package/js/Renderer/WebCodecsRenderer/index.js +5 -5
  35. package/js/Renderer/WebCodecsRendererCache.js +13 -1
  36. package/js/Renderer/WebGLRenderer/index.js +179 -26
  37. package/js/Renderer/YUVCanvasRenderer/index.js +12 -5
  38. package/js/Utils.js +4 -4
  39. package/package.json +7 -6
  40. package/ts/AgoraSdk.ts +2 -12
  41. package/ts/Decoder/index.ts +5 -1
  42. package/ts/Private/AgoraBase.ts +1259 -1060
  43. package/ts/Private/AgoraMediaBase.ts +351 -324
  44. package/ts/Private/AgoraMediaPlayerTypes.ts +94 -91
  45. package/ts/Private/IAgoraLog.ts +20 -18
  46. package/ts/Private/IAgoraMediaEngine.ts +86 -81
  47. package/ts/Private/IAgoraMediaPlayer.ts +196 -181
  48. package/ts/Private/IAgoraMediaPlayerSource.ts +40 -40
  49. package/ts/Private/IAgoraMusicContentCenter.ts +3 -3
  50. package/ts/Private/IAgoraRhythmPlayer.ts +15 -15
  51. package/ts/Private/IAgoraRtcEngine.ts +2498 -2048
  52. package/ts/Private/IAgoraRtcEngineEx.ts +434 -335
  53. package/ts/Private/IAgoraSpatialAudio.ts +43 -45
  54. package/ts/Private/IAudioDeviceManager.ts +106 -97
  55. package/ts/Private/impl/IAgoraMediaPlayerImpl.ts +12 -0
  56. package/ts/Private/impl/IAgoraRtcEngineExImpl.ts +138 -0
  57. package/ts/Private/impl/IAgoraRtcEngineImpl.ts +340 -4
  58. package/ts/Private/internal/AgoraH265TranscoderInternal.ts +8 -6
  59. package/ts/Private/internal/IrisApiEngine.ts +137 -0
  60. package/ts/Private/internal/MediaEngineInternal.ts +8 -6
  61. package/ts/Private/internal/MediaPlayerInternal.ts +8 -6
  62. package/ts/Private/internal/MediaRecorderInternal.ts +10 -7
  63. package/ts/Private/internal/MusicContentCenterInternal.ts +8 -6
  64. package/ts/Private/internal/RtcEngineExInternal.ts +143 -15
  65. package/ts/Private/internal/VideoEffectObjectInternal.ts +14 -0
  66. package/ts/Private/ti/IAgoraRtcEngine-ti.ts +2 -0
  67. package/ts/Renderer/AgoraView.ts +32 -3
  68. package/ts/Renderer/IRenderer.ts +8 -3
  69. package/ts/Renderer/IRendererCache.ts +33 -0
  70. package/ts/Renderer/RendererCache.ts +195 -15
  71. package/ts/Renderer/RendererManager.ts +21 -99
  72. package/ts/Renderer/WebCodecsRenderer/index.ts +9 -6
  73. package/ts/Renderer/WebCodecsRendererCache.ts +17 -1
  74. package/ts/Renderer/WebGLRenderer/index.ts +246 -40
  75. package/ts/Renderer/YUVCanvasRenderer/index.ts +29 -16
  76. package/ts/Types.ts +14 -9
  77. package/ts/Utils.ts +5 -4
  78. package/types/AgoraSdk.d.ts +2 -12
  79. package/types/AgoraSdk.d.ts.map +1 -1
  80. package/types/Decoder/index.d.ts.map +1 -1
  81. package/types/Private/AgoraBase.d.ts +1254 -1060
  82. package/types/Private/AgoraBase.d.ts.map +1 -1
  83. package/types/Private/AgoraMediaBase.d.ts +347 -320
  84. package/types/Private/AgoraMediaBase.d.ts.map +1 -1
  85. package/types/Private/AgoraMediaPlayerTypes.d.ts +95 -92
  86. package/types/Private/AgoraMediaPlayerTypes.d.ts.map +1 -1
  87. package/types/Private/IAgoraLog.d.ts +20 -18
  88. package/types/Private/IAgoraLog.d.ts.map +1 -1
  89. package/types/Private/IAgoraMediaEngine.d.ts +86 -81
  90. package/types/Private/IAgoraMediaEngine.d.ts.map +1 -1
  91. package/types/Private/IAgoraMediaPlayer.d.ts +195 -181
  92. package/types/Private/IAgoraMediaPlayer.d.ts.map +1 -1
  93. package/types/Private/IAgoraMediaPlayerSource.d.ts +40 -40
  94. package/types/Private/IAgoraMusicContentCenter.d.ts +3 -3
  95. package/types/Private/IAgoraRhythmPlayer.d.ts +15 -15
  96. package/types/Private/IAgoraRtcEngine.d.ts +2462 -2057
  97. package/types/Private/IAgoraRtcEngine.d.ts.map +1 -1
  98. package/types/Private/IAgoraRtcEngineEx.d.ts +410 -334
  99. package/types/Private/IAgoraRtcEngineEx.d.ts.map +1 -1
  100. package/types/Private/IAgoraSpatialAudio.d.ts +43 -45
  101. package/types/Private/IAgoraSpatialAudio.d.ts.map +1 -1
  102. package/types/Private/IAudioDeviceManager.d.ts +106 -97
  103. package/types/Private/IAudioDeviceManager.d.ts.map +1 -1
  104. package/types/Private/impl/IAgoraMediaPlayerImpl.d.ts +2 -0
  105. package/types/Private/impl/IAgoraMediaPlayerImpl.d.ts.map +1 -1
  106. package/types/Private/impl/IAgoraRtcEngineExImpl.d.ts +7 -1
  107. package/types/Private/impl/IAgoraRtcEngineExImpl.d.ts.map +1 -1
  108. package/types/Private/impl/IAgoraRtcEngineImpl.d.ts +29 -3
  109. package/types/Private/impl/IAgoraRtcEngineImpl.d.ts.map +1 -1
  110. package/types/Private/internal/AgoraH265TranscoderInternal.d.ts.map +1 -1
  111. package/types/Private/internal/IrisApiEngine.d.ts +4 -0
  112. package/types/Private/internal/IrisApiEngine.d.ts.map +1 -1
  113. package/types/Private/internal/MediaEngineInternal.d.ts.map +1 -1
  114. package/types/Private/internal/MediaPlayerInternal.d.ts.map +1 -1
  115. package/types/Private/internal/MediaRecorderInternal.d.ts.map +1 -1
  116. package/types/Private/internal/MusicContentCenterInternal.d.ts.map +1 -1
  117. package/types/Private/internal/RtcEngineExInternal.d.ts +10 -4
  118. package/types/Private/internal/RtcEngineExInternal.d.ts.map +1 -1
  119. package/types/Private/internal/VideoEffectObjectInternal.d.ts +7 -0
  120. package/types/Private/internal/VideoEffectObjectInternal.d.ts.map +1 -0
  121. package/types/Private/ti/IAgoraRtcEngine-ti.d.ts.map +1 -1
  122. package/types/Renderer/AgoraView.d.ts +6 -0
  123. package/types/Renderer/AgoraView.d.ts.map +1 -1
  124. package/types/Renderer/IRenderer.d.ts +2 -2
  125. package/types/Renderer/IRenderer.d.ts.map +1 -1
  126. package/types/Renderer/IRendererCache.d.ts +21 -1
  127. package/types/Renderer/IRendererCache.d.ts.map +1 -1
  128. package/types/Renderer/RendererCache.d.ts +27 -0
  129. package/types/Renderer/RendererCache.d.ts.map +1 -1
  130. package/types/Renderer/RendererManager.d.ts +4 -17
  131. package/types/Renderer/RendererManager.d.ts.map +1 -1
  132. package/types/Renderer/WebCodecsRenderer/index.d.ts +3 -3
  133. package/types/Renderer/WebCodecsRenderer/index.d.ts.map +1 -1
  134. package/types/Renderer/WebCodecsRendererCache.d.ts +7 -0
  135. package/types/Renderer/WebCodecsRendererCache.d.ts.map +1 -1
  136. package/types/Renderer/WebGLRenderer/index.d.ts +12 -2
  137. package/types/Renderer/WebGLRenderer/index.d.ts.map +1 -1
  138. package/types/Renderer/YUVCanvasRenderer/index.d.ts +3 -2
  139. package/types/Renderer/YUVCanvasRenderer/index.d.ts.map +1 -1
  140. package/types/Types.d.ts +11 -6
  141. package/types/Types.d.ts.map +1 -1
  142. package/types/Utils.d.ts +1 -1
  143. package/types/Utils.d.ts.map +1 -1
package/CHANGELOG.md CHANGED
@@ -1,18 +1,49 @@
1
1
 
2
2
 
3
- ## [4.5.2-dev.2](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-dev.1...v4.5.2-dev.2) (2025-03-14)
3
+ ## [4.5.3-build.1-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.3...v4.5.3-build.1-rc.1) (2026-05-14)
4
4
 
5
- ## [4.5.2-dev.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v0.0.0-dev.1...v4.5.2-dev.1) (2025-03-12)
5
+ ## [4.5.3](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.3-dev.3...v4.5.3) (2026-04-28)
6
6
 
7
- # [0.0.0-dev.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2...v0.0.0-dev.1) (2025-03-12)
7
+ ## [4.5.3-dev.3](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.3-dev.2...v4.5.3-dev.3) (2026-04-03)
8
+
9
+ ## [4.5.3-dev.2](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.3-dev.1...v4.5.3-dev.2) (2026-04-03)
10
+
11
+ ## [4.5.3-dev.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.9-rc.1...v4.5.3-dev.1) (2026-04-03)
12
+
13
+
14
+ ### Features
15
+
16
+ * support 4.6.2 ([#1369](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1369)) ([1b9be80](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/1b9be800cd088c3edba06c335a08eaddd6cab9a7)), closes [#1287](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1287) [#1285](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1285) [#1286](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1286)
17
+
18
+ ## [4.5.2-build.9-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.194-rc.1...v4.5.2-build.9-rc.1) (2026-03-25)
19
+
20
+ ## [4.5.2-build.194-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.180-rc.2...v4.5.2-build.194-rc.1) (2026-03-09)
21
+
22
+ ## [4.5.2-build.180-rc.2](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.174-rc.1...v4.5.2-build.180-rc.2) (2026-02-10)
23
+
24
+ ## [4.5.2-build.174-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.166-rc.1...v4.5.2-build.174-rc.1) (2025-12-29)
25
+
26
+ ## [4.5.2-build.166-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.3-rc.1...v4.5.2-build.166-rc.1) (2025-11-28)
27
+
28
+ ## [4.5.2-build.3-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.143-rc.1...v4.5.2-build.3-rc.1) (2025-09-04)
29
+
30
+
31
+ ### Features
32
+
33
+ * support 4.5.2.3 ([#1329](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1329)) ([a3c83e5](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/a3c83e5505a7943ac00f619653268dbd76e39c09)), closes [#1327](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1327) [#1330](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1330)
34
+
35
+ ## [4.5.2-build.143-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.139-rc.1...v4.5.2-build.143-rc.1) (2025-07-11)
36
+
37
+ ## [4.5.2-build.139-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.131-rc.1...v4.5.2-build.139-rc.1) (2025-06-19)
38
+
39
+ ## [4.5.2-build.131-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.1-build.132-rc.1...v4.5.2-build.131-rc.1) (2025-04-27)
40
+
41
+ ## [4.5.1-build.132-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2...v4.5.1-build.132-rc.1) (2025-04-23)
8
42
 
9
43
 
10
44
  ### Features
11
45
 
12
- * downlaod.js ([7e49fa6](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/7e49fa659c11f219e3d333112c9ae515651ee8f4))
13
- * remove pwd ([37e5d44](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/37e5d446542a42509f87e571142da93082751df2))
14
- * roll back example ([b0e7948](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/b0e79486d51629228465ad81c0e66ee65d3f3bdb))
15
- * update dependencies ([33cf7f6](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/33cf7f683e437484c67a0835222f37bf324f0f0e))
46
+ * support 4.5.1.132 ([#1287](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1287)) ([54b9e83](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/54b9e830e3f1268f2fbe2f59e354333fdade1262)), closes [#1285](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1285) [#1286](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1286)
16
47
 
17
48
  ## [4.5.2](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.1...v4.5.2) (2025-03-11)
18
49
 
package/README.md CHANGED
@@ -1,5 +1,8 @@
1
+ > ⚠️ **Note**: To provide you with better and higher quality technical support services, we will no longer provide technical support through GitHub issues. If you need help, please contact us directly through [Agora Support](https://www.agora.io/en/customer-support/).
2
+
1
3
  > NOTE: These sdk and samples only for the Agora Video 4.x APIs. For examples using previous releases please see the following branches:
2
- > - [3.x](https://github.com/AgoraIO-Extensions/Electron-SDK/tree/3.x)
4
+ >
5
+ > - [3.x](https://github.com/AgoraIO-Extensions/Electron-SDK/tree/3.x)
3
6
 
4
7
  # Agora RTC SDK for Electron
5
8
 
@@ -73,10 +76,10 @@ npm install --agora_electron_sdk_arch=x64
73
76
  ## 🔨 Usage
74
77
 
75
78
  ```javascript
76
- import createAgoraRtcEngine from "agora-electron-sdk";
79
+ import createAgoraRtcEngine from 'agora-electron-sdk';
77
80
 
78
81
  const rtcEngine = createAgoraRtcEngine();
79
- rtcEngine.initialize({appId: "<your agora app id>"});
82
+ rtcEngine.initialize({ appId: '<your agora app id>' });
80
83
  ```
81
84
 
82
85
  ### When using without electron-webpack
package/js/AgoraSdk.js CHANGED
@@ -36,12 +36,7 @@ __exportStar(require("./Types"), exports);
36
36
  __exportStar(require("./Utils"), exports);
37
37
  const instance = new RtcEngineExInternal_1.RtcEngineExInternal();
38
38
  /**
39
- * Creates one IRtcEngineEx object.
40
- *
41
- * Currently, the Agora RTC SDK v4.x supports creating only one IRtcEngineEx object for each app.
42
- *
43
- * @returns
44
- * One IRtcEngineEx object.
39
+ * @ignore
45
40
  */
46
41
  function createAgoraRtcEngine(options) {
47
42
  Object.assign(Utils_1.AgoraEnv, options);
@@ -49,12 +44,7 @@ function createAgoraRtcEngine(options) {
49
44
  }
50
45
  exports.createAgoraRtcEngine = createAgoraRtcEngine;
51
46
  /**
52
- * Gets one IMediaPlayerCacheManager instance.
53
- *
54
- * Before calling any APIs in the IMediaPlayerCacheManager class, you need to call this method to get a cache manager instance of a media player.
55
- *
56
- * @returns
57
- * The IMediaPlayerCacheManager instance.
47
+ * @ignore
58
48
  */
59
49
  function getMediaPlayerCacheManager() {
60
50
  return new IAgoraMediaPlayerImpl_1.IMediaPlayerCacheManagerImpl();
package/js/Decoder/index.js CHANGED
@@ -53,7 +53,7 @@ class WebCodecsDecoder {
53
53
  if (renderer.rendererType !== Types_1.RendererType.WEBCODECSRENDERER) {
54
54
  continue;
55
55
  }
56
- renderer.drawFrame(this.pendingFrame, this._currentCodecConfig);
56
+ renderer.drawFrame(this._cacheContext.uid, this.pendingFrame, this._currentCodecConfig);
57
57
  this.pendingFrame = null;
58
58
  }
59
59
  }