v4.3.0
v4.3.0 が 2024年2月22日にリリースされました。
このリリースでは、複数の API の名前の変更や削除が行われました。
ソースコードに該当箇所が含まれる場合、更新する必要があります。
互換性の変更
- Raw video dataコールバックの処理がランダムスレッド化
- コールバックパラメータ値の変更
- チャンネルメディアリレーのメソッド変更と一部のコールバックを削除
- pushExternalVideoFrame が AgoraRtcEngineKit(Ex) から AgoraRtcEngineKit へ移行
- AgoraAudioOutputRouting 内特定メソッドの名称変更とメソッドの追加
- The state of the remote videoのパラメータ名称変更
- local video state changes のパラメータ名称変更
- ログが暗号化され、コンソールを介した平文のログ出力の非サポート化
- IAgoraEventHandlerインターフェース内のイベントはIRtcEngineEventHandlerへ移行
新機能
- ローカルミキシングされた映像のレイアウト変更をトリガーするコールバックの追加
- 複数のフレームを同時に表示するローカルプレビューをサポート
- デバイスの性能レベルを取得するqueryDeviceScoreメソッドの追加
- ローカル再生用と配信用ものでそれぞれ別のオーディオトラックの指定が可能
- チャンネル入室前にマイクとスピーカーのテストを行うことが可能
改善点
- SDKの処理能力向上
- インイヤーモニタリングの音量調整の柔軟化と最大音量の拡大
- 空間オーディオのユーザビリティ向上
- sourceType パラメータごとに動画前処理メソッドの最適化
修正された問題
- 2つの画面共有を同時に共有する場合、localVideoStatsコールバックで報告されるcaptureFrameRateが0になり、予期しないエラーが発生する問題を修正。
- リモートユーザーの音声がフリーズすることがある問題を修正。
APIの変更
追加
- onTranscodedStreamLayoutInfo
- VideoLayout
- The subviewUid and uid members in VideoCanvas
- The codecType member in VideoEncoderConfiguration
- The allowCaptureCurrentApp member in AudioCaptureParameters
- enableCustomAudioLocalPlayback
- selectMultiAudioTrack
- onPlayerCacheStats
- onPlayerPlaybackStats
- PlayerPlaybackStats
- startPlaybackDeviceTest
- stopPlaybackDeviceTest
- The earMonitorDelay and aecEstimatedDelay members in LocalAudioStats
- queryDeviceScore
- The CUSTOM_VIDEO_SOURCE enumeration in MediaSourceType
- setBeautyEffectOptions [2/2]
- setLowlightEnhanceOptions [2/2]
- setVideoDenoiserOptions [2/2]
- setColorEnhanceOptions [2/2]
- enableVirtualBackground [2/2]
- The AUDIO_ROUTE_BLUETOOTH_DEVICE_A2DP enumeration
修正
- pushExternalVideoFrameEx[1/2] and pushExternalVideoFrameEx[2/2] are renamed to pushExternalVideoFrameById[1/2] and pushExternalVideoFrameById[2/2], and are migrated from RtcEngineEx to RtcEngine
- REMOTE_VIDEO_STATE_PLAYING enumeration name changed toREMOTE_VIDEO_STATE_DECODING
- ROUTE_BLUETOOTH is renamed as AUDIO_ROUTE_BLUETOOTH_DEVICE_HFP
- All ERROR fields in the following enumerations are changed to REASON:
LOCAL_AUDIO_STREAM_ERROR_OKLOCAL_AUDIO_STREAM_ERROR_FAILURELOCAL_AUDIO_STREAM_ERROR_DEVICE_NO_PERMISSIONLOCAL_AUDIO_STREAM_ERROR_DEVICE_BUSYLOCAL_AUDIO_STREAM_ERROR_CAPTURE_FAILURELOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURELOCAL_VIDEO_STREAM_ERROR_OKLOCAL_VIDEO_STREAM_ERROR_FAILURELOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSIONLOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSYLOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURELOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORTLOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUNDPLAYER_ERROR_NONEPLAYER_ERROR_INVALID_ARGUMENTSPLAYER_ERROR_INTERNALPLAYER_ERROR_NO_RESOURCEPLAYER_ERROR_INVALID_MEDIA_SOURCEPLAYER_ERROR_UNKNOWN_STREAM_TYPEPLAYER_ERROR_OBJ_NOT_INITIALIZEDPLAYER_ERROR_CODEC_NOT_SUPPORTEDPLAYER_ERROR_VIDEO_RENDER_FAILEDPLAYER_ERROR_INVALID_STATEPLAYER_ERROR_URL_NOT_FOUNDPLAYER_ERROR_INVALID_CONNECTION_STATEPLAYER_ERROR_SRC_BUFFER_UNDERFLOWPLAYER_ERROR_INTERRUPTEDPLAYER_ERROR_NOT_SUPPORTEDPLAYER_ERROR_TOKEN_EXPIREDPLAYER_ERROR_UNKNOWNRTMP_STREAM_PUBLISH_ERROR_OKRTMP_STREAM_PUBLISH_ERROR_INVALID_ARGUMENTRTMP_STREAM_PUBLISH_ERROR_ENCRYPTED_STREAM_NOT_ALLOWEDRTMP_STREAM_PUBLISH_ERROR_CONNECTION_TIMEOUTRTMP_STREAM_PUBLISH_ERROR_INTERNAL_SERVER_ERRORRTMP_STREAM_PUBLISH_ERROR_RTMP_SERVER_ERRORRTMP_STREAM_PUBLISH_ERROR_TOO_OFTENRTMP_STREAM_PUBLISH_ERROR_REACH_LIMITRTMP_STREAM_PUBLISH_ERROR_NOT_AUTHORIZEDRTMP_STREAM_PUBLISH_ERROR_STREAM_NOT_FOUNDRTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTEDRTMP_STREAM_PUBLISH_ERROR_NOT_BROADCASTERRTMP_STREAM_PUBLISH_ERROR_TRANSCODING_NO_MIX_STREAMRTMP_STREAM_PUBLISH_ERROR_NET_DOWNRTMP_STREAM_PUBLISH_ERROR_INVALID_PRIVILEGERTMP_STREAM_UNPUBLISH_ERROR_OK
削除
startChannelMediaRelayupdateChannelMediaRelaystartChannelMediaRelayExupdateChannelMediaRelayExonChannelMediaRelayEvent
その他の改善点や詳細は以下リンクをご参照ください。
プラットフォームとバージョンを下記ページ内で検索いただけます。
https://docs.agora.io/en/video-calling/overview/release-notes?platform=android