v4.1.1
V4.1.1が2023年2月8日にリリースされました。
互換性の変更
1.デフォルトのビデオ解像度の変更
デフォルトのビデオエンコーディング解像度を640 × 360から960 × 540にアップグレードしました。setVideoEncoderConfiguration メソッドを呼び出すと、ビデオエンコーディングパラメーター設定に期待されるビデオエンコーディング解像度を設定できます。
※留意事項として、デフォルトの解像度が変更する事で利用料が変わる可能性が御座います。
2.API名の変更
setRemoteVideo のメソッド名が setRemoteVideoSubscriptionOptions に、setRemoteVideoEx のメソッド名が setRemoteVideoSubscriptionOptionsEx に変更されています。
SDK をこのバージョン以降にアップグレードする場合は、サービスへの影響を避けるために、これら 2 つのメソッドの名前を確実に変更してください。
新機能
- 初期フレームのレンダリング高速化
- ビデオレンダリングトレース
改善点
- onRenderVideoFrameコールバックの最適化
- 元のビデオの品質が損なわれている場合でも、受信側でより高い解像度へビデオ品質をアップスケーリング
修正された問題
- サンプルレートが48 kHzのオーディオファイルの再生に失敗する問題を修正。
- プレーヤーのレンダリングビューが UIViewController のビューとして設定されている場合、フルスクリーンモードに入ると、動画が左下から画面中央にズームされる問題を修正。
- チャンネルに参加して外部カメラにアクセスするとき、ビデオキャプチャデバイスを外部カメラに指定するために setDevice を呼び出しても、それが有効になっていない問題を修正。
- バグ番号: UDevC0016818251 チャンネルに複数のビデオストリームがある時、一部のビデオ拡張 API の呼び出しに失敗することがある問題を修正。
APIの変更
追加
- enableInstantMediaRendering
- startMediaRenderingTracing
- startMediaRenderingTracingEx
- videoRenderingTracingResultOfUid
- AgoraMediaRenderTraceEvent
- VideoRenderingTracingInfo
修正
- setRemoteVideo が setRemoteVideoSubscriptionOptions に
- setRemoteVideoEx が setRemoteVideoSubscriptionOptionsEx に
削除
- enableRemoteSuperResolution
- AgoraRtcRemoteVideoStats の superResolutionType
詳細は以下リンクをご参照ください。
https://docs.agora.io/en/video-calling/overview/release-notes?platform=macos
v4.1.0
V4.1.0が2022年12月15日にリリースされました。
新機能
1. ヘッドホンイコライザーエフェクトによる低周波と高周波のパラメータの調整
2. エンコードされた映像のフレーム確認
3. MultiPath UDP(ベータ版)(※)
4. カメラキャプチャーオプションの追加
5. マルチチャンネル管理のメソッド追加
6.ビデオエンコーディングのオプション追加
7. ClientRoleのオプション追加
(※) 利用をご希望の場合、お問い合わせください。
改善点
- 画面共有の機能向上
- チャンネル間のメディアストリームメソッドの最適化
- AIAECアルゴリズムの再構成
- バーチャル背景アルゴリズムの最適化
その他の改善
- 外部オーディオ ソースをプッシュする際のレイテンシを短縮。
AUDIO_SCENARIO_MEETING
シナリオ使用時のエコーキャンセルのパフォーマンスを改善。- SDK ビデオ レンダリングの滑らかさを改善。
- ホストが muteLocalVideoStream メソッドを呼び出す際の、ローカルデバイスの CPU 使用率と電力消費量を削減。
- さまざまなネットワーク プロトコル スタックを識別する機能を強化し、複数オペレーター ネットワーク シナリオでの SDK のアクセス機能を改善。
修正された問題
- Macの画面共有で、共有アプリケーションのウィンドウを最小化したり閉じたりすると、同じアプリケーションの別のウィンドウが自動的に共有されることがある問題を修正。
- 画面共有時に、ローカルユーザーのシステム音量が小さくなることがある問題を修正。
- 画面共有において、分割画面の共有ウィンドウが正しくハイライトされないことがある問題を修正。
- 画面共有において、相手側の画面がクラッシュしたり、遅延したり、黒い画面が表示されることがある問題を修正。
- networkQualityコールバックによって報告されるアップリンクのネットワーク品質が、画面共有をしているユーザーに対して不正確である問題を修正。
- オーディオキャプチャデバイスのテストを開始・停止した後、オーディオ再生デバイスを開始すると音が出なくなることがある問題を修正。
- ライブストリーミング中に司会者がスピーカーとイヤホンを切り替えると、観客にブーンというノイズが聞こえる問題を修正。
- didVideoPublishStateChange コールバックの内容が不正確である問題を修正。
- getExtensionProperty の呼び出しに失敗し、空の文字列が返される問題を修正。
- 長時間再生されるライブストリーミングルームに観客として入る場合、最初のフレームがレンダリングされるまでの時間が短縮される問題を修正。
APIの変更
追加
- setHeadphoneEQParameters
- setRemoteVideoSubscriptionOptions
- setRemoteVideoSubscriptionOptionsEx
- AgoraVideoSubscriptionOptions
- muteLocalAudioStreamEx
- muteLocalVideoStreamEx
- muteAllRemoteAudioStreamsEx
- muteAllRemoteVideoStreamsEx
- startRtmpStreamWithoutTranscodingEx
- startRtmpStreamWithTranscodingEx
- updateRtmpTranscodingEx
- stopRtmpStreamEx
- startChannelMediaRelayEx
- updateChannelMediaRelayEx
- pauseAllChannelMediaRelayEx
- resumeAllChannelMediaRelayEx
- stopChannelMediaRelayEx
- followEncodeDimensionRatio in AgoraCameraCapturerConfiguration
- hwEncoderAccelerating in AgoraRtcLocalVideoStats
- leaveChannelEx [2/2]
- advancedVideoOptions in AgoraVideoEncoderConfiguration
- newRoleOptions in didClientRoleChanged
- adjustUserPlaybackSignalVolumeEx
- enableAudioVolumeIndicationEx
非推奨
- didApiCallExecute
削除
- AgoraLiveTranscoding クラスの非推奨のメンバーパラメータ backgroundImage と watermark
- didReceiveChannelMediaRelayEvent コールバックの AgoraChannelMediaRelayEventUpdateDestinationChannelRefused(8)
詳細は以下リンクをご参照ください。
プラットフォームとバージョンを下記ページ内で検索いただけます。
https://docs.agora.io/en/video-calling/overview/release-notes?platform=macos