Video SDK for iOS v4.3.x リリース

v4.3.0​

v4.3.0 が 2024年2月22日にリリースされました。

このリリースでは、複数の API の名前の変更や削除が行われました。
ソースコードに該当箇所が含まれる場合、更新する必要があります。

互換性の変更​

1. コールバックパラメータの名称変更
2. チャンネルメディアリレーのメソッド変更と一部のコールバックを削除
3. pushExternalVideoFrame が AgoraRtcEngineKit(Ex) から AgoraRtcEngineKit へ移行
4. AgoraAudioOutputRouting 内特定メソッドの名称変更とメソッドの追加
5. AgoraLocalVideoStreamErrorEncodeFailure 列挙の名称変更
6. SDKログの暗号化

新機能

1. ローカルミキシングされた映像のレイアウト変更をトリガーするコールバックの追加
2. 複数のフレームを同時に表示するローカルプレビューをサポート
3. デバイスの性能レベルを取得するqueryDeviceScoreメソッドの追加
4. ローカル再生用と配信用ものでそれぞれ別のオーディオトラックの指定が可能
5. チャンネル入室前にマイクとスピーカーのテストを行うことが可能

改善点

1. SDKの処理能力向上
2. インイヤーモニタリングの音量調整の柔軟化と最大音量の拡大
3. 空間オーディオのユーザビリティ向上
4. LocalAudioStateChanged のコールバック追加
5. sourceType パラメータごとに動画前処理メソッドの最適化

修正された問題

2つの画面共有を同時に共有する場合、localVideoStatsコールバックで報告されるcaptureFrameRateが0になり、予期しないエラーが発生する問題を修正。

APIの変更

追加

• didTranscodedStreamLayoutInfoUpdatedWithUserId
• AgoraVideoLayoutInfo
• The subviewUid member in AgoraRtcVideoCanvas
• updateSelfTransform
• The AgoraAudioLocalReasonInterrupted enumeration in AgoraAudioLocalReason
• enableCustomAudioLocalPlayback
• queryDeviceScore
• The AgoraMediaSourceTypeCustomVideo enumeration in AgoraMediaSourceType
• setBeautyEffectOptions [2/2]
• setLowlightEnhanceOptions [2/2]
• setVideoDenoiserOptions [2/2]
• setColorEnhanceOptions [2/2]
• enableVirtualBackground [2/2]
• The AgoraAudioOutputRoutingBluetoothDeviceA2dp enumeration in AgoraAudioOutputRouting
• Adds the earMonitorDelay and aecEstimatedDelay in AgoraRtcLocalAudioStats
• selectMultiAudioTrack
• cacheStats
• playbackStats
• AgoraMediaPlayerPlaybackStats
• startPlaybackDeviceTest
• stopPlaybackDeviceTest

修正

• pushExternalVideoFrame[1/2] is migrated from AgoraRtcEngineKit(Ex) to AgoraRtcEngineKit
• AgoraAudioOutputRoutingBluetooth is renamed as AgoraAudioOutputRoutingBluetoothDeviceHfp
• 以下APIは、「Error」の名称が「Reason」に変更されます
  • AgoraAudioLocalErrorOK
  • AgoraAudioLocalErrorFailure
  • AgoraAudioLocalErrorDeviceNoPermission
  • AgoraAudioLocalErrorDeviceBusy
  • AgoraAudioLocalErrorRecordFailure
  • AgoraAudioLocalErrorEncodeFailure
  • AgoraLocalVideoStreamErrorOK
  • AgoraLocalVideoStreamErrorFailure
  • AgoraLocalVideoStreamErrorDeviceNoPermission
  • AgoraLocalVideoStreamErrorDeviceBusy
  • AgoraLocalVideoStreamErrorCaptureFailure
  • AgoraLocalVideoStreamErrorCodecNotSupport
  • AgoraLocalVideoStreamErrorCaptureInBackGround
  • AgoraLocalVideoStreamErrorCaptureMultipleForegroundApps
  • AgoraLocalVideoStreamErrorCaptureNoDeviceFound
  • AgoraLocalVideoStreamErrorCaptureDeviceDisconnected
  • AgoraLocalVideoStreamErrorCaptureDeviceInvalidId
  • AgoraDirectCdnStreamingErrorOK
  • AgoraDirectCdnStreamingErrorFailed
  • AgoraDirectCdnStreamingErrorAudioPublication
  • AgoraDirectCdnStreamingErrorVideoPublication
  • AgoraDirectCdnStreamingErrorNetConnect
  • AgoraDirectCdnStreamingErrorBadName
  • AgoraMediaPlayerErrorNone
  • AgoraMediaPlayerErrorInvalidArguments
  • AgoraMediaPlayerErrorInternal
  • AgoraMediaPlayerErrorNoSource
  • AgoraMediaPlayerErrorInvalidMediaSource
  • AgoraMediaPlayerErrorUnknowStreamType
  • AgoraMediaPlayerErrorObjNotInitialized
  • AgoraMediaPlayerErrorCodecNotSupported
  • AgoraMediaPlayerErrorVideoRenderFailed
  • AgoraMediaPlayerErrorInvalidState
  • AgoraMediaPlayerErrorUrlNotFound
  • AgoraMediaPlayerErrorInvalidConnectState
  • AgoraMediaPlayerErrorSrcBufferUnderflow
  • AgoraMediaPlayerErrorInterrupted
  • AgoraMediaPlayerErrorNotSupported
  • AgoraMediaPlayerErrorTokenExpired
  • AgoraMediaPlayerErrorUnknown
  • AgoraRtmpStreamingErrorOK
  • AgoraRtmpStreamingErrorInvalidParameters
  • AgoraRtmpStreamingErrorEncryptedStreamNotAllowed
  • AgoraRtmpStreamingErrorConnectionTimeout
  • AgoraRtmpStreamingErrorInternalServerError
  • AgoraRtmpStreamingErrorRtmpServerError
  • AgoraRtmpStreamingErrorTooOften
  • AgoraRtmpStreamingErrorReachLimit
  • AgoraRtmpStreamingErrorNotAuthorized
  • AgoraRtmpStreamingErrorStreamNotFound
  • AgoraRtmpStreamingErrorFormatNotSupported
  • AgoraRtmpStreamingErrorNotBroadcaster
  • AgoraRtmpStreamingErrorTranscodingNoMixStream
  • AgoraRtmpStreamingErrorNetDown
  • AgoraRtmpStreamingErrorInvalidPrivilege
  • AgoraRtmpStreamingErrorUnpublishOK

削除

• startChannelMediaRelay
• updateChannelMediaRelay
• startChannelMediaRelayEx
• updateChannelMediaRelayEx
• didReceiveChannelMediaRelayEvent
• AgoraChannelMediaRelayEvent

その他の改善点や詳細は以下リンクをご参照ください。

プラットフォームとバージョンを下記ページ内で検索いただけます。

https://docs.agora.io/en/video-calling/overview/release-notes?platform=ios