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_OK
LOCAL_AUDIO_STREAM_ERROR_FAILURE
LOCAL_AUDIO_STREAM_ERROR_DEVICE_NO_PERMISSION
LOCAL_AUDIO_STREAM_ERROR_DEVICE_BUSY
LOCAL_AUDIO_STREAM_ERROR_CAPTURE_FAILURE
LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE
LOCAL_VIDEO_STREAM_ERROR_OK
LOCAL_VIDEO_STREAM_ERROR_FAILURE
LOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSION
LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY
LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE
LOCAL_VIDEO_STREAM_ERROR_CODEC_NOT_SUPPORT
LOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUND
PLAYER_ERROR_NONE
PLAYER_ERROR_INVALID_ARGUMENTS
PLAYER_ERROR_INTERNAL
PLAYER_ERROR_NO_RESOURCE
PLAYER_ERROR_INVALID_MEDIA_SOURCE
PLAYER_ERROR_UNKNOWN_STREAM_TYPE
PLAYER_ERROR_OBJ_NOT_INITIALIZED
PLAYER_ERROR_CODEC_NOT_SUPPORTED
PLAYER_ERROR_VIDEO_RENDER_FAILED
PLAYER_ERROR_INVALID_STATE
PLAYER_ERROR_URL_NOT_FOUND
PLAYER_ERROR_INVALID_CONNECTION_STATE
PLAYER_ERROR_SRC_BUFFER_UNDERFLOW
PLAYER_ERROR_INTERRUPTED
PLAYER_ERROR_NOT_SUPPORTED
PLAYER_ERROR_TOKEN_EXPIRED
PLAYER_ERROR_UNKNOWN
RTMP_STREAM_PUBLISH_ERROR_OK
RTMP_STREAM_PUBLISH_ERROR_INVALID_ARGUMENT
RTMP_STREAM_PUBLISH_ERROR_ENCRYPTED_STREAM_NOT_ALLOWED
RTMP_STREAM_PUBLISH_ERROR_CONNECTION_TIMEOUT
RTMP_STREAM_PUBLISH_ERROR_INTERNAL_SERVER_ERROR
RTMP_STREAM_PUBLISH_ERROR_RTMP_SERVER_ERROR
RTMP_STREAM_PUBLISH_ERROR_TOO_OFTEN
RTMP_STREAM_PUBLISH_ERROR_REACH_LIMIT
RTMP_STREAM_PUBLISH_ERROR_NOT_AUTHORIZED
RTMP_STREAM_PUBLISH_ERROR_STREAM_NOT_FOUND
RTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTED
RTMP_STREAM_PUBLISH_ERROR_NOT_BROADCASTER
RTMP_STREAM_PUBLISH_ERROR_TRANSCODING_NO_MIX_STREAM
RTMP_STREAM_PUBLISH_ERROR_NET_DOWN
RTMP_STREAM_PUBLISH_ERROR_INVALID_PRIVILEGE
RTMP_STREAM_UNPUBLISH_ERROR_OK
削除
startChannelMediaRelay
updateChannelMediaRelay
startChannelMediaRelayEx
updateChannelMediaRelayEx
onChannelMediaRelayEvent
その他の改善点や詳細は以下リンクをご参照ください。
プラットフォームとバージョンを下記ページ内で検索いただけます。
https://docs.agora.io/en/video-calling/overview/release-notes?platform=android