##############
リリースノート
##############

CHANGE
    後方互換性のない変更
UPDATE
    後方互換性がある変更
ADD
    後方互換性がある追加
FIX
    バグ修正

2024.1.0
=======================

:日時: 2024-02-26
:対応 Sora: 2023.1.0 以降
:対応 iOS: 13.0 以降
:対応 libwebrtc: m121.6167.4.0

変更履歴
---------------

- [CHANGE] Sora 2022.1.0 にて ``metadata_list`` が廃止されたのに伴い、 ``SignalingNotify`` の ``metadataList`` を削除しました

  - 代わりに ``SignalingNotify`` の ``data`` で値を取得できます
- [CHANGE] VideoView のバックエンドを RTCEAGLVideoView から RTCMTLVideoView に変更しました

  - libwebrtc のアップデートに伴い ``RTCEAGLVideoView`` が ``deprecated`` になったことに伴う修正です
- [UPDATE] システム条件を変更しました

  - macOS 14.3.1 以降
  - WebRTC SFU Sora 2023.2.0 以降
  - CocoaPods 1.15.2 以降
  - Xcode 15.2
  - Swift 5.9.2
- [UPDATE] CameraVideoCapturer のログを出力するようにしました
- [UPDATE] libwebrtc のバージョンを 121.6167.4.0 に更新しました

  - HEVC (H.265) 対応パッチを含んだバージョンです
- [UPDATE] 解像度に qHD (960x540) を追加しました
- [UPDATE] CocoaPods を v1.15.2 に更新しました
- [UPDATE] Sora 2023.2.0 で対応した ``ForwardingFilter`` の ``version`` と ``metadata`` を追加しました
- [ADD] ``VideoCodec`` にハードウェアアクセラレーターを利用した HEVC(H.265) の映像を送受信できるようにするコーデック指定 ``H265`` を追加しました
- [ADD] リソースの逼迫により、送信する映像の品質が維持できない場合に、解像度やフレームレートのどちらを維持するかを指定できる設定 ``degradationPreference`` を ``WebRTCConfiguration`` に追加しました

  - 詳細については :ref:`degradation-preference` をご確認ください
- [FIX] ``ForwardingFilter`` の ``action`` を未指定にできるように修正しました
- [FIX] ``SignalingNotify`` に項目を追加しました

  - ``sessionId``
  - ``kind``
  - ``destinationConnectionId``
  - ``sourceConnectionId``
  - ``recvConnectionId``
  - ``sendConnectionId``
  - ``streamId``

2023.3.1
=========================

:日時: 2023-10-24
:対応 Sora: 2023.1.0
:対応 iOS: 13.0 以降
:対応 libwebrtc: m116.5845.6.1

変更履歴
---------------

- [FIX] AVCaptureDevice.Format の選択時にフレームレートを考慮するように修正しました

  - フレームレートに 60 を設定しても、 AVFrameRateRange が 1-30 の AVCaptureDevice.Format が選択されてしまうケースがあったため修正しました
  - 修正前は、カメラから同じ解像度の AVCaptureDevice.Format が複数取得された場合、最初に解像度が一致した AVCaptureDevice.Format を選択しており、フレームレートが考慮されていなかったことが原因です

2023.3.0
==============================

:日時: 2023-09-13
:対応 Sora: 2023.1.0
:対応 iOS: 13.0 以降
:対応 libwebrtc: m116.5845.6.1

変更履歴
---------------

- [CHANGE] ``@available(*, unavailable)`` アトリビュートの項目を削除しました

  - Swift 5.9 以降 ``@available(*, unavailable)`` アトリビュートが禁止されたことによる対応です
  - 削除した項目を利用していた場合ビルドエラーが発生するため :ref:`braking-change-2023.3.0` を参照して対応をお願いします
- [CHANGE] ``@available(*, deprecated, ... )`` としていた非推奨項目を削除する

  - 非推奨であった項目について削除に移行しました
  - 削除した項目を利用していた場合ビルドエラーが発生するため :ref:`braking-change-2023.3.0` を参照して対応をお願いします
- [CHANGE] ``PeerChannel.swift`` と ``SignalingChannel.swift`` の ``onConnectHandler`` を ``onConnect`` に置き換えました

  - 既に他のファイルでは名称変更を行なっていたがこのファイルのみ変更が行われていなかったため対応する
- [UPDATE] WebRTC 116.5845.6.1 に対応しました
- [FIX] ``MediaChannel`` の ``connectionCount``, ``publisherCount``, ``subscriberCount`` に値が設定されない不具合を修正しました

  - Sora のシグナリングメッセージ、 channel_upstream_connections, channel_downstream_connections が廃止された契機で値が設定されなくなっていました
  - Sora のシグナリングメッセージ、channel_sendrecv_connections, channel_sendonly_connections, channel_recvonly_connections, channel_connections を元に値を設定するよう修正

2023.2.0
==============================

:日時: 2023-08-01
:対応 Sora: 2023.1.0
:対応 iOS: 13.0 以降
:対応 libwebrtc: m115.5790.7.0

変更履歴
---------------

- [UPDATE] WebRTC 115.5790.7.0 に対応しました
- [UPDATE] システム条件を変更しました

  - macOS 13.4.1 以降
  - WebRTC SFU Sora 2023.1.0 以降
  - Xcode 14.3.1
  - Swift 5.8.1
  - CocoaPods 1.12.1 以降
- [ADD] サイマルキャストを VP9 / AV1 で利用できるようにしました
- [ADD] 接続時に転送フィルターを指定できるようにしました

  - ``Configuration`` に ``forwardingFilter`` を追加しました
  - 詳細は :ref:`forwarding-filter` をご確認ください
- [ADD] 接続時に映像コーデックパラメーターを指定できるようにしました

  - ``Configuration`` に ``videoVp9Params``, ``videoAv1Params``, ``videoH264Params`` を追加しました
  - 詳細は :ref:`video-codec-parameters` をご確認ください

2023.1.0
==============================

:日時: 2023-04-07
:対応 Sora: 2022.2.0
:対応 iOS: 13.0 以降
:対応 libwebrtc: m112.5615.1.0

変更履歴
---------------

- [UPDATE] WebRTC 112.5615.1.0 に対応しました
- [UPDATE] システム条件を変更しました

  - macOS 13.3 以降
  - Xcode 14.3
  - Swift 5.8
  - WebRTC SFU Sora 2022.2.0 以降
- [UPDATE] ``CameraSettings`` の ``Resolution`` に ``uhd2160p``, ``uhd3024p`` を追加しました
- [ADD] ``Configuration`` に ``audioStreamingLanguageCode`` を追加しました
- [FIX] m107.5304.4.1 利用時、シグナリング時に EXEC_BAD_ACCESS が発生する事象を修正しました

  - ``RTCPeerConnection.offer()`` に渡すブロック内で ``RTCPeerConnection.close()`` を呼んでいるのが原因だと思われるため、 async/await を使って offer() の終了を待ってから close() するよう修正しました
  - ``RTCPeerConnection.offer()`` の実行が非同期で行われるようになりましたが、 ``NativePeerChannelFactory.createClientOfferSDP()`` の用途では問題はありません