####################### 移行ドキュメント ####################### .. _braking-change-2023.3.0: 2023.3.0 で実施する利用不可項目の削除について ====================================================================== 概要 ------- ``@available(*, unavailable)`` および、 ``@available(*, deprecated, ... )`` の項目について削除を行います。 これらの項目について利用している場合は 2023.3.0 でビルドエラーが発生します。以下のドキュメントを参考に移行への対応をお願いします。 経緯 ------- ``@available(*, unavailable)`` について、Swift 5.9 以降 ``@available(*, unavailable) attribute`` が廃止となるため削除をします。 このアトリビュートはプロパティが廃止済みであることを伝えるためのものです。 ``@available(*, deprecated, ... )`` については非推奨 (廃止予定) の項目について移行を促すために記載していたものです。 1 年以上経過しているため削除をします。 移行先の項目は廃止項目をご確認ください。 廃止項目 --------------- @available(\*, unavailable) が指定されている項目 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ すでに廃止されており、Sora iOS SDK 2023.2.0 時点の SDK で利用した場合はビルドエラーが発生する項目です。 移行が未完了の場合は、以下を参考に移行をお願いします。 - ``Configration`` の ``url`` - シグナリング URL の複数指定が可能となったため廃止となりました。 - ``urlCandidates`` で代替してください。 - ``Configration`` の ``signalingChannelHandlers`` - 廃止となりました。利用できません。 - ``mediaChannelHandlers`` で代替してください。 - ``Configration`` の ``PeerChannelHandlers`` - 廃止となりました。利用できません。 - ``mediaChannelHandlers`` で代替してください。 - ``Configration`` の ``signalingChannelType`` - 廃止となりました。利用できません。 - ``Configration`` の ``webSocketChannelType`` - 廃止となりました。利用できません。 - ``Configration`` の ``peerChannelType`` - 廃止となりました。利用できません。 - ``Configration`` の ``allowsURLSessionWebSocketChannel`` - 廃止となりました。利用できません。 - ``Configration`` の ``videoCapturerDevice`` - 廃止となりました。利用できません。 - カメラの設定については ``Configration`` の ``cameraSettings`` にて指定できます。 - カスタムキャプチャーについては ``MediaStream.send(videoFrame:)`` を利用して映像フレームを送信してください。 - :ref:`camera` も参考にしてください。 - ``MediaChannelHandlers`` の ``webSocketChannel`` - 廃止となりました。利用できません。 - ``WebSocketChannelHandlers`` の ``onMessageHandler`` - ``onReceive`` に置き換えられました。 - ``WebSocketChannelHandlers`` の ``onDisconnectHandler`` - 廃止となりました。利用できません。 - ``WebSocketChannelHandlers`` の ``onPongHandler`` - 廃止となりました。利用できません。 - ``WebSocketChannelHandlers`` の ``onSendHandler`` - 廃止となりました。利用できません。 - ``WebSocketChannelHandlers`` の ``onDisconnect`` - 廃止となりました。利用できません。 - ``WebSocketChannelHandlers`` の ``onPong`` - 廃止となりました。利用できません。 - ``WebSocketChannelHandlers`` の ``onSend`` - 廃止となりました。利用できません。 - ``WebSocketChannel`` - 廃止となりました。利用できません。 - ``VideoCapturerDevice`` - 廃止となりました。利用できません。 - ``VideoCapturer`` - 廃止となりました。利用できません。 - カスタムキャプチャーについては ``MediaStream.send(videoFrame:)`` を利用して映像フレームを送信してください。 - ``VideoCapturerHandlers`` - 廃止となりました。利用できません。 - カスタムキャプチャーについては ``MediaStream.send(videoFrame:)`` を利用して映像フレームを送信してください。 - ``CameraVideoCapturer`` の ``shared`` - 廃止となりました。利用できません。 - 起動中の ``CameraVideoCapturer`` は ``CameraVideoCapturer.current!`` で取得できます。 - ``CameraVideoCapturer`` の ``settings`` - 廃止となりました。利用できません。 - ``CameraSettings`` に定義を行うように変更しています。 - ``CameraVideoCapturer`` の ``captureDevices`` - ``CameraVideoCapturer`` の ``devices`` を利用して取得をおこなってください。 - ``CameraVideoCapturer`` の ``captureDevice(for position: AVCaptureDevice.Position)`` - ``CameraVideoCapturer`` の ``device(for position: AVCaptureDevice.Position)`` を利用して取得をおこなってください。 - ``CameraVideoCapturer`` の ``suitableFormat(for device: AVCaptureDevice, resolution: Any)`` - 廃止となりました。利用できません。 - ``CameraVideoCapturer`` の ``format(width: Int32, height: Int32, for device: AVCaptureDevica, frameRate: Int?)`` で代替してください。 - ``CameraVideoCapturer`` の ``suitableFrameRate(for format: AVCaptureDevice.Format, frameRate: Int)`` - 廃止となりました。利用できません。 - ``CameraVideoCapturer`` の ``maxFrameRate(_ frameRate: Int, for format: AVCaptureDevice.Format)`` で代替してください。 - ``CameraVideoCapturer`` の ``canStop`` - 廃止となりました。利用できません。 - Sora との切断時にカメラは自動的に停止されます。 - ``CameraVideoCapturer`` の ``stopWhenDone`` - 廃止となりました。利用できません。 - Sora との切断時にカメラは自動的に停止されます。 - ``CameraVideoCapturer`` の ``stopWhenDone`` - 廃止となりました。利用できません。 - Sora との切断時にカメラは自動的に停止されます。 - ``SignalingMetadata`` - 廃止となりました。利用できません。 - メタデータは Any? を任意の型にキャストして利用してください。 - ``SignalingClientMetadata`` - 廃止となりました。利用できません。 - ``SignalingNotifyMetadata`` で代替してください。 - ``SignalingNotifyEventType`` - 廃止となりました。利用できません。 - ``SignalingNotifyConnection`` - 廃止となりました。利用できません。 - この Struct の定義は ``SignalingNotify`` に集約されています。 - ``SignalingNotifySpotlightChanged`` - 廃止となりました。利用できません。 - この Struct の定義は ``SignalingNotify`` に集約されています。 - ``SignalingNotifyNetworkStatus`` - 廃止となりました。利用できません。 - この Struct の定義は ``SignalingNotify`` に集約されています。 - ``DeviceInfo`` の ``model`` - 廃止となりました。利用できません。 @available(\*, deprecated, ... ) が指定されている項目 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Sora iOS SDK 2023.2.0 までは警告のみで内部的に移行先に値を設定しておりビルドエラーは発生しませんでした。項目自体を削除したため、以下を参考に移行をお願いします。 移行が未完了の場合は、以下を参考に移行をお願いします。 - ``Role`` の ``publisher`` - 廃止となりました。利用できません。 - ``sendonly`` で代替してください。 - ``Role`` の ``subscriber`` - 廃止となりました。利用できません。 - ``recvonly`` で代替してください。 - ``Role`` の ``group`` - 廃止となりました。利用できません。 - ``sendrecv`` で代替してください。 - ``Role`` の ``groupSub`` - 廃止となりました。利用できません。 - ``recvonly`` で代替してください。 - ``Configration`` の ``init`` - 初期化時にマルチストリームの指定が必須となりました。 - ``Configuration(url: url, channelId: soraChannelId, role: .recvonly, multistreamEnabled: false)`` のように指定してください。 - ``Configration`` の ``spotlight`` - ``spotlightNumber`` に置き換えられました。 - ``Configration`` の ``activeSpeakerLimit`` - ``spotlightNumber`` に置き換えられました。 - ``SignalingConnect`` の ``spotlight`` - ``spotlightNumber`` に置き換えられました。 - ``SignalingConnect`` の ``activeSpeakerLimit`` - ``spotlightNumber`` に置き換えられました。 - ``SignalingNotify`` の ``publisherCount`` - 廃止となりました。利用できません。 - ``channelSendonlyConnections`` と ``channelSendrecvConnections`` の合計値で代替してください。 - ``SignalingNotify`` の ``subscriberCount`` - 廃止となりました。利用できません。 - ``channelRecvonlyConnections`` と ``channelSendrecvConnections`` の合計値で代替してください。 - ``SoraHandlers`` の ``onConnectHandler`` - ``onConnect`` に置き換えられました。 - ``SoraHandlers`` の ``onDisconnectHandler`` - ``onDisconnect`` に置き換えられました。 - ``SoraHandlers`` の ``onAddMediaChannelHandler`` - ``onAddMediaChannel`` に置き換えられました。 - ``SoraHandlers`` の ``onRemoveMediaChannelHandler`` - ``onRemoveMediaChannel`` に置き換えられました。 - ``MediaChannelHandlers`` の ``onConnectHandler`` - ``onConnect`` に置き換えられました。 - ``MediaChannelHandlers`` の ``onDisconnectHandler`` - ``onDisconnect`` に置き換えられました。 - ``MediaChannelHandlers`` の ``onAddStream`` - ``onRemoveStreamHandler`` に置き換えられました。 - ``MediaChannelHandlers`` の ``onDisconnectHandler`` - ``onRemoveStream`` に置き換えられました。 - ``MediaChannelHandlers`` の ``onReceiveSignalingHandler`` - ``onReceiveSignaling`` に置き換えられました。 - ``MediaStreamHandlers`` の ``onSwitchVideoHandler`` - ``onSwitchVideo`` に置き換えられました。 - ``MediaStreamHandlers`` の ``onSwitchAudioHandler`` - ``onSwitchAudio`` に置き換えられました。 - ``CameraPosition`` - 起動時のカメラ設定は ``Configuration.cameraSettings.position`` の ``.front`` または ``.back`` を設定します。 - 起動後のカメラの切り替えは ``CameraVideoCapturer`` の ``flip(_:completionHandler:)`` を使用します。 - :ref:`camera` も参考にしてください。 - ``CameraVideoCapturer`` の ``currentCameraDevice`` - ``CameraVideoCapturer`` の ``device`` を利用して取得をおこなってください。