agora-electron-sdk 4.5.40-rc.3 → 4.6.2

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 (137) hide show
  1. package/CHANGELOG.md +8 -26
  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 +1015 -710
  6. package/js/Private/AgoraMediaBase.js +154 -151
  7. package/js/Private/AgoraMediaPlayerTypes.js +54 -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 +163 -103
  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/AgoraMediaBaseImpl.js +1 -1
  18. package/js/Private/impl/IAgoraMediaPlayerImpl.js +10 -0
  19. package/js/Private/impl/IAgoraRtcEngineExImpl.js +136 -0
  20. package/js/Private/impl/IAgoraRtcEngineImpl.js +319 -58
  21. package/js/Private/internal/IrisApiEngine.js +45 -0
  22. package/js/Private/internal/RtcEngineExInternal.js +74 -4
  23. package/js/Private/internal/VideoEffectObjectInternal.js +14 -0
  24. package/js/Private/ti/AgoraMediaBase-ti.js +1 -1
  25. package/js/Private/ti/IAgoraRtcEngine-ti.js +8 -5
  26. package/js/Renderer/AgoraView.js +19 -2
  27. package/js/Renderer/IRenderer.js +7 -4
  28. package/js/Renderer/IRendererCache.js +17 -1
  29. package/js/Renderer/RendererCache.js +153 -10
  30. package/js/Renderer/RendererManager.js +13 -64
  31. package/js/Renderer/WebCodecsRenderer/index.js +5 -5
  32. package/js/Renderer/WebCodecsRendererCache.js +13 -1
  33. package/js/Renderer/WebGLRenderer/index.js +179 -26
  34. package/js/Renderer/YUVCanvasRenderer/index.js +12 -5
  35. package/js/Utils.js +4 -4
  36. package/package.json +7 -17
  37. package/scripts/build.js +0 -9
  38. package/scripts/download.js +1 -3
  39. package/scripts/downloadPrebuild.js +2 -56
  40. package/scripts/synclib.js +3 -25
  41. package/scripts/util.js +2 -5
  42. package/ts/AgoraSdk.ts +2 -12
  43. package/ts/Decoder/index.ts +5 -1
  44. package/ts/Private/AgoraBase.ts +1541 -1111
  45. package/ts/Private/AgoraMediaBase.ts +348 -324
  46. package/ts/Private/AgoraMediaPlayerTypes.ts +90 -91
  47. package/ts/Private/IAgoraLog.ts +20 -18
  48. package/ts/Private/IAgoraMediaEngine.ts +87 -82
  49. package/ts/Private/IAgoraMediaPlayer.ts +196 -181
  50. package/ts/Private/IAgoraMediaPlayerSource.ts +40 -40
  51. package/ts/Private/IAgoraMusicContentCenter.ts +3 -3
  52. package/ts/Private/IAgoraRhythmPlayer.ts +15 -15
  53. package/ts/Private/IAgoraRtcEngine.ts +2630 -2086
  54. package/ts/Private/IAgoraRtcEngineEx.ts +479 -331
  55. package/ts/Private/IAgoraSpatialAudio.ts +43 -45
  56. package/ts/Private/IAudioDeviceManager.ts +106 -97
  57. package/ts/Private/impl/AgoraMediaBaseImpl.ts +1 -0
  58. package/ts/Private/impl/IAgoraMediaPlayerImpl.ts +12 -0
  59. package/ts/Private/impl/IAgoraRtcEngineExImpl.ts +240 -0
  60. package/ts/Private/impl/IAgoraRtcEngineImpl.ts +464 -78
  61. package/ts/Private/internal/IrisApiEngine.ts +47 -0
  62. package/ts/Private/internal/RtcEngineExInternal.ts +106 -9
  63. package/ts/Private/internal/VideoEffectObjectInternal.ts +14 -0
  64. package/ts/Private/ti/AgoraMediaBase-ti.ts +1 -1
  65. package/ts/Private/ti/IAgoraRtcEngine-ti.ts +8 -5
  66. package/ts/Renderer/AgoraView.ts +32 -3
  67. package/ts/Renderer/IRenderer.ts +8 -3
  68. package/ts/Renderer/IRendererCache.ts +34 -0
  69. package/ts/Renderer/RendererCache.ts +195 -10
  70. package/ts/Renderer/RendererManager.ts +21 -99
  71. package/ts/Renderer/WebCodecsRenderer/index.ts +9 -6
  72. package/ts/Renderer/WebCodecsRendererCache.ts +17 -1
  73. package/ts/Renderer/WebGLRenderer/index.ts +246 -40
  74. package/ts/Renderer/YUVCanvasRenderer/index.ts +29 -16
  75. package/ts/Types.ts +14 -9
  76. package/ts/Utils.ts +5 -4
  77. package/types/AgoraSdk.d.ts +2 -12
  78. package/types/AgoraSdk.d.ts.map +1 -1
  79. package/types/Decoder/index.d.ts.map +1 -1
  80. package/types/Private/AgoraBase.d.ts +1528 -1110
  81. package/types/Private/AgoraBase.d.ts.map +1 -1
  82. package/types/Private/AgoraMediaBase.d.ts +344 -321
  83. package/types/Private/AgoraMediaBase.d.ts.map +1 -1
  84. package/types/Private/AgoraMediaPlayerTypes.d.ts +90 -91
  85. package/types/Private/AgoraMediaPlayerTypes.d.ts.map +1 -1
  86. package/types/Private/IAgoraLog.d.ts +20 -18
  87. package/types/Private/IAgoraLog.d.ts.map +1 -1
  88. package/types/Private/IAgoraMediaEngine.d.ts +87 -82
  89. package/types/Private/IAgoraMediaEngine.d.ts.map +1 -1
  90. package/types/Private/IAgoraMediaPlayer.d.ts +195 -181
  91. package/types/Private/IAgoraMediaPlayer.d.ts.map +1 -1
  92. package/types/Private/IAgoraMediaPlayerSource.d.ts +40 -40
  93. package/types/Private/IAgoraMusicContentCenter.d.ts +3 -3
  94. package/types/Private/IAgoraRhythmPlayer.d.ts +15 -15
  95. package/types/Private/IAgoraRtcEngine.d.ts +2553 -2075
  96. package/types/Private/IAgoraRtcEngine.d.ts.map +1 -1
  97. package/types/Private/IAgoraRtcEngineEx.d.ts +439 -331
  98. package/types/Private/IAgoraRtcEngineEx.d.ts.map +1 -1
  99. package/types/Private/IAgoraSpatialAudio.d.ts +43 -45
  100. package/types/Private/IAgoraSpatialAudio.d.ts.map +1 -1
  101. package/types/Private/IAudioDeviceManager.d.ts +106 -97
  102. package/types/Private/IAudioDeviceManager.d.ts.map +1 -1
  103. package/types/Private/impl/AgoraMediaBaseImpl.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 +13 -1
  107. package/types/Private/impl/IAgoraRtcEngineExImpl.d.ts.map +1 -1
  108. package/types/Private/impl/IAgoraRtcEngineImpl.d.ts +36 -8
  109. package/types/Private/impl/IAgoraRtcEngineImpl.d.ts.map +1 -1
  110. package/types/Private/internal/IrisApiEngine.d.ts.map +1 -1
  111. package/types/Private/internal/RtcEngineExInternal.d.ts +10 -4
  112. package/types/Private/internal/RtcEngineExInternal.d.ts.map +1 -1
  113. package/types/Private/internal/VideoEffectObjectInternal.d.ts +7 -0
  114. package/types/Private/internal/VideoEffectObjectInternal.d.ts.map +1 -0
  115. package/types/Private/ti/IAgoraRtcEngine-ti.d.ts.map +1 -1
  116. package/types/Renderer/AgoraView.d.ts +6 -0
  117. package/types/Renderer/AgoraView.d.ts.map +1 -1
  118. package/types/Renderer/IRenderer.d.ts +2 -2
  119. package/types/Renderer/IRenderer.d.ts.map +1 -1
  120. package/types/Renderer/IRendererCache.d.ts +22 -1
  121. package/types/Renderer/IRendererCache.d.ts.map +1 -1
  122. package/types/Renderer/RendererCache.d.ts +27 -0
  123. package/types/Renderer/RendererCache.d.ts.map +1 -1
  124. package/types/Renderer/RendererManager.d.ts +4 -17
  125. package/types/Renderer/RendererManager.d.ts.map +1 -1
  126. package/types/Renderer/WebCodecsRenderer/index.d.ts +3 -3
  127. package/types/Renderer/WebCodecsRenderer/index.d.ts.map +1 -1
  128. package/types/Renderer/WebCodecsRendererCache.d.ts +7 -0
  129. package/types/Renderer/WebCodecsRendererCache.d.ts.map +1 -1
  130. package/types/Renderer/WebGLRenderer/index.d.ts +12 -2
  131. package/types/Renderer/WebGLRenderer/index.d.ts.map +1 -1
  132. package/types/Renderer/YUVCanvasRenderer/index.d.ts +3 -2
  133. package/types/Renderer/YUVCanvasRenderer/index.d.ts.map +1 -1
  134. package/types/Types.d.ts +11 -6
  135. package/types/Types.d.ts.map +1 -1
  136. package/types/Utils.d.ts +1 -1
  137. package/types/Utils.d.ts.map +1 -1
package/CHANGELOG.md CHANGED
@@ -1,43 +1,25 @@
1
1
 
2
2
 
3
- ## [4.5.40-rc.3](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.40-rc.2...v4.5.40-rc.3) (2025-12-25)
4
-
5
-
6
- ### Bug Fixes
7
-
8
- * add LINK_FLAGS property to Agora node extension target in CMakeLists.txt ([13c63a0](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/13c63a0795433e52a4d6f8ec3682a0f9cfebb2b3))
9
- * remove debug message from CMakeLists.txt and ensure CMAKE_JS_LIB is linked ([2113ce4](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/2113ce4e3d347954797a66e1bd6d2c0265fd054b))
10
- * remove unnecessary RPATH settings and update LINK_FLAGS for Agora node extension ([752d23e](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/752d23eada57faa02498fd81d5a6b5f3cf463a02))
11
- * update CMakeLists.txt to use CMAKE_SYSTEM_NAME for Linux detection ([e85734a](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/e85734a5db03795e14ed86d204e1421ac60ef65e))
12
- * update LINK_FLAGS for Agora node extension to disable new dynamic tags ([6864259](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/6864259b93d112acb3dc0613915ca18d407d2658))
3
+ ## [4.6.2](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2...v4.6.2) (2026-03-05)
13
4
 
14
5
 
15
6
  ### Features
16
7
 
17
- * add support for ARM64 cross-compilation in CMakeLists.txt and update build scripts ([d008283](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/d008283b92797aa6e49e42e40ed67e2561e10b23))
18
- * arm64 ([33a2ea5](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/33a2ea577b45b2aee1e813d7c9c0d8beb94d6193))
19
-
8
+ * 4.6 for atlas ([#1396](https://github.com/AgoraIO-Extensions/Electron-SDK/issues/1396)) ([5fcf9a5](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/5fcf9a51642ec3ce6e4e5d32059b2ab90bea3356))
9
+ * 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)
20
10
 
21
- ### Reverts
22
-
23
- * Revert "chore: optimize" ([0be4b6e](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/0be4b6ed8385561b9dec988854ce0ae14d0f52ce))
24
- * Revert "chore: optimize" ([edbd4cd](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/edbd4cd9212ba4b194203eea1893ab0d95ff8e28))
25
- * Revert "chore: optimize" ([24a715f](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/24a715f0a8f8095eb5551285c233eef040cdfc14))
11
+ ## [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)
26
12
 
27
- ## [4.5.40-rc.2](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.40-rc.1...v4.5.40-rc.2) (2025-09-28)
13
+ ## [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)
28
14
 
29
15
 
30
16
  ### Features
31
17
 
32
- * **downloadPrebuild:** add support for Linux platform in native SDK download and file handling ([0299504](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/02995042880b2274c10fb2673c5a873767d47d82))
33
-
34
- ## [4.5.40-rc.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.5.2-build.131-rc.1...v4.5.40-rc.1) (2025-09-28)
18
+ * 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)
35
19
 
20
+ ## [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
21
 
37
- ### Features
38
-
39
- * support linux ([e8a8b08](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/e8a8b08bc7cae8b1fa44404d3a310b562e39821b))
40
- * support linux for 4.5.40 ([30dc852](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/30dc85218e4232357dde488e546a364d573f4789))
22
+ ## [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)
41
23
 
42
24
  ## [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)
43
25
 
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
- * 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();
@@ -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
  }