@byteplus/react-native-rtc 1.1.1 → 1.3.2

package/lib/typescript/codegen/android/api.d.ts

@@ -251,16 +251,160 @@ export declare class RTCRoom {
     sendRoomBinaryMessage(buffer: ArrayBuffer): long;
     setMultiDeviceAVSync(audioUserId: String): int;
     setRemoteVideoConfig(userId: String, remoteVideoConfig: RemoteVideoConfig): int;
-    publishStream(type: MediaStreamType): int;
-    unpublishStream(type: MediaStreamType): int;
-    publishScreen(type: MediaStreamType): int;
-    unpublishScreen(type: MediaStreamType): int;
-    subscribeStream(uid: String, type: MediaStreamType): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Start or stop publishing video streams captured by camera in the current room.
+     * @param publish Whether to publish the media stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ReturnStatus{@link #ReturnStatus} for more details
+     * @note
+     *        - You don't need to call this API if you set it to Auto-publish when calling joinRoom{@link #RTCRoom#joinRoom}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #RTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenAudio{@link #RTCRoom#publishScreenAudio} (not supported on Linux) and/or publishScreenVideo{@link #RTCRoom#publishScreenVideo} to start or stop screen sharing.
+     *        - Call publishStreamAudio{@link #RTCRoom#publishStreamAudio} to start or stop publishing the audio stream captured by the microphone.
+     *        - Call startForwardStreamToRooms{@link #RTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you call this API, the other users in the room will receive onUserPublishStreamVideo{@link #IRTCRoomEventHandler#onUserPublishStreamVideo}. Those who successfully received your streams will receive onFirstRemoteVideoFrameDecoded{@link #IRTCEngineEventHandler#onFirstRemoteVideoFrameDecoded} at the same time.
+     *
+     */
+    publishStreamVideo(publish: boolean): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Start or stop publishing media streams captured by the local microphone in the current room.
+     * @param publish Whether to publish the media stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ReturnStatus{@link #ReturnStatus} for more details
+     * @note
+     *        - You don't need to call this API if you set it to Auto-publish when calling joinRoom{@link #RTCRoom#joinRoom}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #RTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenAudio{@link #RTCRoom#publishScreenAudio} (not supported on Linux) and/or publishScreenVideo{@link #RTCRoom#publishScreenVideo} to start or stop screen sharing.
+     *        - Call publishStreamVideo{@link #RTCRoom#publishStreamVideo} to start or stop publishing the video stream captured by the camera.
+     *        - Call startForwardStreamToRooms{@link #RTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you call this API, the other users in the room will receive onUserPublishStreamAudio{@link #IRTCRoomEventHandler#onUserPublishStreamAudio}. Those who successfully received your streams will receive onFirstRemoteAudioFrame{@link #IRTCEngineEventHandler#onFirstRemoteAudioFrame} at the same time.
+     *
+     */
+    publishStreamAudio(publish: boolean): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Start or stop sharing the local screen in the room.
+     *        If you need to share your screen in multiple rooms, you can use the same uid to join multiple rooms and call this API in each room. Also, you can publish different types of screen-sharing streams in different rooms.
+     * @param publish Whether to publish video stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ReturnStatus{@link #ReturnStatus} for more details
+     * @note
+     *        - You need to call this API to publish screen even if you set it to Auto-publish when calling joinRoom{@link #RTCRoom#joinRoom}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #RTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenAudio{@link #RTCRoom#publishScreenAudio} (not supported on Linux) to start or stop sharing computer audio.
+     *        - Call publishStreamVideo{@link #RTCRoom#publishStreamVideo} to start or stop publishing the video stream captured by the camera.
+     *        - Call publishStreamAudio{@link #RTCRoom#publishStreamAudio} to start or stop publishing the audio stream captured by the microphone.
+     *        - Call startForwardStreamToRooms{@link #RTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you called this API, the other users in the room will receive onUserPublishScreenVideo{@link #IRTCRoomEventHandler#onUserPublishScreenVideo}. Those who successfully received your streams will receive onFirstRemoteVideoFrameDecoded{@link #IRTCEngineEventHandler#onFirstRemoteVideoFrameDecoded} at the same time.
+     *        - After calling this API, you'll receive onScreenVideoFrameSendStateChanged{@link #IRTCEngineEventHandler#onScreenVideoFrameSendStateChanged}.
+     *        - Refer to [Sharing Screen in PC](https://docs.byteplus.com/byteplus-rtc/docs/70144) for more information.
+     *
+     */
+    publishScreenVideo(publish: boolean): int;
+    /** {en}
+     * @hidden(Linux)
+     * @detail api
+     * @valid since 3.60.
+     * @brief Manually publishes local screen-sharing streams in the current room. <br>
+     *        If you need to share your screen in multiple rooms, you can use the same uid to join multiple rooms and call this API in each room. Also, you can publish different types of screen-sharing streams in different rooms.
+     * @param publish Media stream type, used for specifying whether to publish audio stream or video stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ReturnStatus{@link #ReturnStatus} for more details
+     * @note
+     *        - You need to call this API to publish screen even if you set it to Auto-publish when calling joinRoom{@link #RTCRoom#joinRoom}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #RTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenVideo{@link #RTCRoom#publishScreenVideo} to start or stop sharing the local screen.
+     *        - Call publishStreamVideo{@link #RTCRoom#publishStreamVideo} to start or stop publishing the video stream captured by the camera.
+     *        - Call publishStreamAudio{@link #RTCRoom#publishStreamAudio} to start or stop publishing the audio stream captured by the microphone.
+     *        - Call startForwardStreamToRooms{@link #RTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you called this API, the other users in the room will receive onUserPublishScreenAudio{@link #IRTCRoomEventHandler#onUserPublishScreenAudio}. Those who successfully received your streams will receive onFirstRemoteAudioFrame{@link #IRTCEngineEventHandler#onFirstRemoteAudioFrame} at the same time.
+     *        - Refer to [Sharing Screen in PC](https://docs.byteplus.com/byteplus-rtc/docs/70144) for more information.
+     *
+     */
+    publishScreenAudio(publish: boolean): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific remote media streams captured by the local camera.  Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target video stream.
+     * @param subscribe Whether to subscribe to the stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ReturnStatus{@link #ReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through onUserPublishStreamVideo{@link #IRTCRoomEventHandler#onUserPublishStreamVideo} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onVideoSubscribeStateChanged{@link #IRTCRoomEventHandler#onVideoSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeStreamVideo{@link #RTCRoom#subscribeStreamVideo}.
+     *        - Any other exceptions will be included in onVideoSubscribeStateChanged{@link #IRTCRoomEventHandler#onVideoSubscribeStateChanged}, see SubscribeStateChangeReason{@link #SubscribeStateChangeReason} for the reasons.
+     *
+     */
+    subscribeStreamVideo(userId: String, subscribe: boolean): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific remote media streams captured by the local microphone.  Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target media stream.
+     * @param subscribe Whether to subscribe to the audio stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ReturnStatus{@link #ReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through onUserPublishStreamAudio{@link #IRTCRoomEventHandler#onUserPublishStreamAudio} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onAudioSubscribeStateChanged{@link #IRTCRoomEventHandler#onAudioSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeStreamAudio{@link #RTCRoom#subscribeStreamAudio}.
+     *        - Any other exceptions will be included in onAudioSubscribeStateChanged{@link #IRTCRoomEventHandler#onAudioSubscribeStateChanged}, see ErrorCode{@link #ErrorCode} for the reasons.
+     *
+     */
+    subscribeStreamAudio(userId: String, subscribe: boolean): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific screen sharing media stream. Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target screen video stream.
+     * @param subscribe Whether to subscribe to the screen video stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ReturnStatus{@link #ReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through onUserPublishScreenVideo{@link #IRTCRoomEventHandler#onUserPublishScreenVideo} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onScreenVideoSubscribeStateChanged{@link #IRTCRoomEventHandler#onScreenVideoSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeScreenVideo{@link #RTCRoom#subscribeScreenVideo}.
+     *        - Any other exceptions will be included in onScreenVideoSubscribeStateChanged{@link #IRTCRoomEventHandler#onScreenVideoSubscribeStateChanged}, see SubscribeStateChangeReason{@link #SubscribeStateChangeReason} for the reasons.
+     *
+     */
+    subscribeScreenVideo(userId: String, subscribe: boolean): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific screen sharing media stream. Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target screen audio stream.
+     * @param subscribe Whether to subscribe to the screen audio stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ReturnStatus{@link #ReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through onUserPublishScreenAudio{@link #IRTCRoomEventHandler#onUserPublishScreenAudio} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onScreenAudioSubscribeStateChanged{@link #IRTCRoomEventHandler#onScreenAudioSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeScreenAudio{@link #RTCRoom#subscribeScreenAudio}.
+     *        - Any other exceptions will be included in onScreenAudioSubscribeStateChanged{@link #IRTCRoomEventHandler#onScreenAudioSubscribeStateChanged}, see SubscribeStateChangeReason{@link #SubscribeStateChangeReason} for the reasons.
+     *
+     */
+    subscribeScreenAudio(userId: String, subscribe: boolean): int;
     subscribeAllStreams(type: MediaStreamType): int;
-    unsubscribeStream(uid: String, type: MediaStreamType): int;
     unsubscribeAllStreams(type: MediaStreamType): int;
-    subscribeScreen(uid: String, type: MediaStreamType): int;
-    unsubscribeScreen(uid: String, type: MediaStreamType): int;
     pauseAllSubscribedStream(mediaType: PauseResumeControlMediaType): int;
     resumeAllSubscribedStream(mediaType: PauseResumeControlMediaType): int;
     startForwardStreamToRooms(forwardStreamInfos: List<ForwardStreamInfo>): int;

package/lib/typescript/codegen/android/callback.d.ts

@@ -1,7 +1,7 @@
 // Copyright © 2022 BytePlusRTC All rights reserved.
 // SPDX-License-Identifier: MIT
 
-import { RTCRoomStats, AVSyncState, UserInfo, MediaStreamType, StreamRemoveReason, LocalStreamStats, RemoteStreamStats, SubscribeConfig, ForwardStreamStateInfo, ForwardStreamEventInfo, NetworkQualityStats, SetRoomExtraInfoResult, UserVisibilityChangeError, SubtitleState, SubtitleMessage, RTCStream, PlayState, KTVPlayerErrorCode, PlayerState, PlayerError, RemoteStreamKey, RTCEncodedVideoFrame, MusicInfo, HotMusicInfo, DownloadResult, SingScoringRealtimeInfo, FaceDetectionResult, ByteRTCStreamMixingEvent, MixedStreamType, VideoFrame, IAudioFrame, ByteRTCStreamMixingType, StreamIndex, MediaPlayerCustomSourceSeekWhence, SysStats, LocalAudioStreamState, LocalAudioStreamError, RemoteAudioState, RemoteAudioStateChangeReason, LocalVideoStreamState, LocalVideoStreamError, RemoteVideoState, RemoteVideoStateChangeReason, VideoSuperResolutionMode, VideoSuperResolutionModeChangedReason, VideoDenoiseMode, VideoDenoiseModeChangedReason, VideoFrameInfo, AudioRoute, SEIStreamUpdateEvent, NetworkDetectionLinkType, NetworkDetectionStopReason, RemoteStreamSwitch, PerformanceAlarmMode, PerformanceAlarmReason, SourceWantedData, RtcUser, FirstFrameSendState, FirstFramePlayState, AudioDeviceType, VideoDeviceType, RecordingState, RecordingErrorCode, RecordingInfo, RecordingProgress, AudioRecordingState, LocalAudioPropertiesInfo, RemoteAudioPropertiesInfo, SyncInfoStreamType, DataMessageSourceType, EchoTestResult, HardwareEchoDetectionResult, LocalProxyType, LocalProxyState, LocalProxyError, MuteState, AudioPlaybackDevice, AudioMixingState, AudioMixingError } from './keytype';
+import { RTCRoomStats, AVSyncState, UserInfo, StreamRemoveReason, LocalStreamStats, RemoteStreamStats, SubscribeConfig, ForwardStreamStateInfo, ForwardStreamEventInfo, NetworkQualityStats, SetRoomExtraInfoResult, UserVisibilityChangeError, SubtitleState, SubtitleMessage, RTCStream, PlayState, KTVPlayerErrorCode, PlayerState, PlayerError, RemoteStreamKey, RTCEncodedVideoFrame, MusicInfo, HotMusicInfo, DownloadResult, SingScoringRealtimeInfo, FaceDetectionResult, ByteRTCStreamMixingEvent, MixedStreamType, VideoFrame, IAudioFrame, ByteRTCStreamMixingType, StreamIndex, MediaPlayerCustomSourceSeekWhence, SysStats, LocalAudioStreamState, LocalAudioStreamError, RemoteAudioState, RemoteAudioStateChangeReason, LocalVideoStreamState, LocalVideoStreamError, RemoteVideoState, RemoteVideoStateChangeReason, VideoSuperResolutionMode, VideoSuperResolutionModeChangedReason, VideoDenoiseMode, VideoDenoiseModeChangedReason, VideoFrameInfo, AudioRoute, SEIStreamUpdateEvent, NetworkDetectionLinkType, NetworkDetectionStopReason, RemoteStreamSwitch, PerformanceAlarmMode, PerformanceAlarmReason, SourceWantedData, RtcUser, FirstFrameSendState, FirstFramePlayState, AudioDeviceType, VideoDeviceType, RecordingState, RecordingErrorCode, RecordingInfo, RecordingProgress, AudioRecordingState, LocalAudioPropertiesInfo, RemoteAudioPropertiesInfo, SyncInfoStreamType, DataMessageSourceType, EchoTestResult, HardwareEchoDetectionResult, LocalProxyType, LocalProxyState, LocalProxyError, MuteState, AudioPlaybackDevice, AudioMixingState, AudioMixingError, PublishState, PublishStateChangeReason, SubscribeState, SubscribeStateChangeReason } from './keytype';
 import { String, int, ByteBuffer, long, JSONObject, double, Bitmap } from './types';
 import { SubtitleErrorCode, ByteRTCStreamSinglePushEvent, KTVErrorCode, ByteRTCTranscoderErrorCode, AudioRecordingErrorCode, PublicStreamErrorCode } from './errorcode';
 export declare class IRTCRoomEventHandler {
@@ -15,10 +15,18 @@ export declare class IRTCRoomEventHandler {
     onTokenWillExpire?(): void;
     onPublishPrivilegeTokenWillExpire?(): void;
     onSubscribePrivilegeTokenWillExpire?(): void;
-    onUserPublishStream?(uid: String, type: MediaStreamType): void;
-    onUserUnpublishStream?(uid: String, type: MediaStreamType, reason: StreamRemoveReason): void;
-    onUserPublishScreen?(uid: String, type: MediaStreamType): void;
-    onUserUnpublishScreen?(uid: String, type: MediaStreamType, reason: StreamRemoveReason): void;
+    onUserPublishStreamVideo?(roomId: String, uid: String, isPublish: boolean): void;
+    onUserPublishStreamAudio?(roomId: String, uid: String, isPublish: boolean): void;
+    onUserPublishScreenVideo?(roomId: String, uid: String, isPublish: boolean): void;
+    onUserPublishScreenAudio?(roomId: String, uid: String, isPublish: boolean): void;
+    onVideoPublishStateChanged?(roomId: String, uid: String, state: PublishState, reason: PublishStateChangeReason): void;
+    onAudioPublishStateChanged?(roomId: String, uid: String, state: PublishState, reason: PublishStateChangeReason): void;
+    onScreenVideoPublishStateChanged?(roomId: String, uid: String, state: PublishState, reason: PublishStateChangeReason): void;
+    onScreenAudioPublishStateChanged?(roomId: String, uid: String, state: PublishState, reason: PublishStateChangeReason): void;
+    onVideoSubscribeStateChanged?(roomId: String, uid: String, state: SubscribeState, reason: SubscribeStateChangeReason): void;
+    onAudioSubscribeStateChanged?(roomId: String, uid: String, state: SubscribeState, reason: SubscribeStateChangeReason): void;
+    onScreenVideoSubscribeStateChanged?(roomId: String, uid: String, state: SubscribeState, reason: SubscribeStateChangeReason): void;
+    onScreenAudioSubscribeStateChanged?(roomId: String, uid: String, state: SubscribeState, reason: SubscribeStateChangeReason): void;
     onLocalStreamStats?(stats: LocalStreamStats): void;
     onRemoteStreamStats?(stats: RemoteStreamStats): void;
     onStreamSubscribed?(stateCode: int, userId: String, info: SubscribeConfig): void;

package/lib/typescript/codegen/android/keytype.d.ts

@@ -503,11 +503,49 @@ export declare enum RemoteMirrorType {
     NONE = 0,
     RENDER = 1
 }
+export declare enum PublishStateChangeReason {
+    PUBLISH = 0,
+    UNPUBLISH = 1,
+    NO_PUBLISH_PERMISSION = 2,
+    OVER_STREAM_PUBLISH_LIMIT = 3,
+    MULTIROOM_UNPUBLISH_FAILED = 4,
+    PUBLISH_STREAM_FAILED = 5,
+    PUBLISH_STREAM_FORBIDEN = 6,
+    USER_IN_PUBLISH = 7
+}
+export declare enum PublishState {
+    /** {en}
+     * @brief Successfully published.
+     *
+     */
+    PUBLISHED = 0,
+    /** {en}
+     * @brief Failed to publish.
+     *
+     */
+    UNPUBLISHED = 1
+}
+export declare enum SubscribeStateChangeReason {
+    SUBSCRIBE = 0,
+    UNSUBSCRIBE = 1,
+    REMOTE_PUBLISH = 2,
+    REMOTE_UNPUBLISH = 3,
+    STREAM_FAILED_5XX = 4,
+    STREAM_FAILED_404 = 5,
+    OVER_STREAM_SUBSCRIBE_LIMIT = 6,
+    NO_SUBSCRIBE_PERMISSION = 7
+}
 export declare enum SubscribeState {
-    SUBSCRIBE_STATE_SUCCESS = 0,
-    SUBSCRIBE_STATE_FAILED_NOT_IN_ROOM = 1,
-    SUBSCRIBE_STATE_FAILED_STREAM_NOT_FOUND = 2,
-    SUBSCRIBE_STATE_FAILED_SIGNAL = 4
+    /** {en}
+     * @brief Successfully subscribed.
+     *
+     */
+    SUBSCRIBED = 0,
+    /** {en}
+     * @brief Failed to subscribe.
+     *
+     */
+    UNSUBSCRIBED = 1
 }
 export declare class VirtualBackgroundSource {
     sourceType: VirtualBackgroundSourceType;
@@ -726,13 +764,44 @@ export declare enum AVSyncState {
     AV_SYNC_STATE_VIDEO_STREAM_REMOVE = 2
 }
 export declare class RTCRoomConfig {
-    constructor(channelProfile: ChannelProfile, isAutoPublish: boolean, isAutoSubscribeAudio: boolean, isAutoSubscribeVideo: boolean, remoteVideoConfig: RemoteVideoConfig);
-    constructor(channelProfile: ChannelProfile, isAutoPublish: boolean, isAutoSubscribeAudio: boolean, isAutoSubscribeVideo: boolean);
+    constructor(channelProfile: ChannelProfile, isPublishAudio: boolean, isPublishVideo: boolean, isAutoSubscribeAudio: boolean, isAutoSubscribeVideo: boolean, remoteVideoConfig: RemoteVideoConfig);
+    /** {en}
+     * @brief Room profile. See ChannelProfile{@link #ChannelProfile}. The default is `CHANNEL_PROFILE_COMMUNICATION`. The setting cannot be changed after joining the room.
+     *
+     */
     profile: ChannelProfile;
-    isAutoPublish: boolean;
+    /** {en}
+     * @brief Whether to publish media streams automatically. The default is automatic publishing.
+     *        + Changing the user role to audience via `setUserVisibility` will void this setting.
+     *        + You can publish streams in only one of the rooms you have participated. If you have joined multiple rooms with the automatically publishing setting, the stream will be added into the first room you have joined only.
+     *
+     */
+    isPublishAudio: boolean;
+    /** {en}
+     * @brief Whether to publish media streams automatically. The default is automatic publishing.
+     *        + Changing the user role to audience via `setUserVisibility` will void this setting.
+     *        + You can publish streams in only one of the rooms you have participated. If you have joined multiple rooms with the automatically publishing setting, the stream will be added into the first room you have joined only.
+     *
+     */
+    isPublishVideo: boolean;
+    /** {en}
+     * @brief Whether to automatically subscribe to the audio stream. The default is automatic subscription. <br>
+     *        This setting affects both the main stream and the screen-sharing stream.
+     *
+     */
     isAutoSubscribeAudio: boolean;
+    /** {en}
+     * @brief Whether to automatically subscribe to the main video stream. The default is automatic subscription. <br>
+     *        This setting affects both the main stream and the screen-sharing stream.
+     *
+     */
     isAutoSubscribeVideo: boolean;
+    /** {en}
+     * @brief Expected configuration of remote video stream, see RemoteVideoConfig{@link #RemoteVideoConfig}.
+     *
+     */
     remoteVideoConfig: RemoteVideoConfig;
+    isPublishAudio$(): boolean;
 }
 export declare enum SVCLayer {
     DEFAULT = 0,
@@ -1928,12 +1997,41 @@ export declare enum MediaStreamType {
     RTC_MEDIA_STREAM_TYPE_BOTH = 3
 }
 export declare enum MediaDeviceState {
+    /** {en}
+     * @brief Device started capturing
+     *
+     */
     MEDIA_DEVICE_STATE_STARTED = 1,
+    /** {en}
+     * @brief Device stopped capturing
+     *
+     */
     MEDIA_DEVICE_STATE_STOPPED = 2,
+    /** {en}
+     * @brief Runtime error <br>
+     *        For example, when the media device is expected to be working but no data is received.
+     *
+     */
     MEDIA_DEVICE_STATE_RUNTIMEERROR = 3,
+    /** {en}
+     * @brief Device is added.
+     *
+     */
     MEDIA_DEVICE_STATE_ADDED = 10,
+    /** {en}
+     * @brief Device is removed.
+     *
+     */
     MEDIA_DEVICE_STATE_REMOVED = 11,
+    /** {en}
+     * @brief A Phone call interrupted the RTC call. RTC call will resume once the call ends.
+     *
+     */
     MEDIA_DEVICE_STATE_INTERRUPTION_BEGAN = 12,
+    /** {en}
+     * @brief RTC call resumed from the interruption caused by a phone call.
+     *
+     */
     MEDIA_DEVICE_STATE_INTERRUPTION_ENDED = 13
 }
 export declare class Layout$Region {

package/lib/typescript/codegen/ios/api.d.ts

@@ -112,24 +112,160 @@ export declare class ByteRTCRoom {
     leaveRoom(): int;
     updateToken(token: NSString): int;
     setRemoteVideoConfig(userId: NSString, remoteVideoConfig: ByteRTCRemoteVideoConfig): int;
-    publishStream(type: ByteRTCMediaStreamType): int;
-    publishStreamVideo(enable: bool): int;
-    publishStreamAudio(enable: bool): int;
-    subscribeStreamVideo(userId: NSString, enable: bool): int;
-    subscribeStreamAudio(userId: NSString, enable: bool): int;
-    publishScreenVideo(enable: bool): int;
-    publishScreenAudio(enable: bool): int;
-    subscribeScreenVideo(userId: NSString, enable: bool): int;
-    subscribeScreenAudio(userId: NSString, enable: bool): int;
-    unpublishStream(type: ByteRTCMediaStreamType): int;
-    publishScreen(type: ByteRTCMediaStreamType): int;
-    unpublishScreen(type: ByteRTCMediaStreamType): int;
-    subscribeStream(userId: NSString, mediaStreamType: ByteRTCMediaStreamType): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Start or stop publishing video streams captured by camera in the current room.
+     * @param publish Whether to publish the media stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for more details
+     * @note
+     *        - You don't need to call this API if you set it to Auto-publish when calling joinRoom:userInfo:roomConfig:{@link #ByteRTCRoom#joinRoom:userInfo:roomConfig}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #IRTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenAudio:{@link #ByteRTCRoom#publishScreenAudio} (not supported on Linux) and/or publishScreenVideo:{@link #ByteRTCRoom#publishScreenVideo} to start or stop screen sharing.
+     *        - Call publishStreamAudio:{@link #ByteRTCRoom#publishStreamAudio} to start or stop publishing the audio stream captured by the microphone.
+     *        - Call startForwardStreamToRooms:{@link #ByteRTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you call this API, the other users in the room will receive rtcRoom:onUserPublishStreamVideo:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishStreamVideo:uid:isPublish}. Those who successfully received your streams will receive rtcEngine:onFirstRemoteVideoFrameDecoded:withFrameInfo:{@link #ByteRTCRoomDelegate#rtcEngine:onFirstRemoteVideoFrameDecoded:withFrameInfo} at the same time.
+     *
+     */
+    publishStreamVideo(publish: BOOL): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Start or stop publishing media streams captured by the local microphone in the current room.
+     * @param publish Whether to publish the media stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for more details
+     * @note
+     *        - You don't need to call this API if you set it to Auto-publish when calling joinRoom:userInfo:roomConfig:{@link #ByteRTCRoom#joinRoom:userInfo:roomConfig}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #IRTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenAudio:{@link #ByteRTCRoom#publishScreenAudio} (not supported on Linux) and/or publishScreenVideo:{@link #ByteRTCRoom#publishScreenVideo} to start or stop screen sharing.
+     *        - Call publishStreamVideo:{@link #ByteRTCRoom#publishStreamVideo} to start or stop publishing the video stream captured by the camera.
+     *        - Call startForwardStreamToRooms:{@link #ByteRTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you call this API, the other users in the room will receive rtcRoom:onUserPublishStreamAudio:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishStreamAudio:uid:isPublish}. Those who successfully received your streams will receive rtcEngine:onFirstRemoteAudioFrame:{@link #ByteRTCEngineDelegate#rtcEngine:onFirstRemoteAudioFrame} at the same time.
+     *
+     */
+    publishStreamAudio(publish: BOOL): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Start or stop sharing the local screen in the room.
+     *        If you need to share your screen in multiple rooms, you can use the same uid to join multiple rooms and call this API in each room. Also, you can publish different types of screen-sharing streams in different rooms.
+     * @param publish Whether to publish video stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for more details
+     * @note
+     *        - You need to call this API to publish screen even if you set it to Auto-publish when calling joinRoom:userInfo:roomConfig:{@link #ByteRTCRoom#joinRoom:userInfo:roomConfig}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #IRTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenAudio:{@link #ByteRTCRoom#publishScreenAudio} (not supported on Linux) to start or stop sharing computer audio.
+     *        - Call publishStreamVideo:{@link #ByteRTCRoom#publishStreamVideo} to start or stop publishing the video stream captured by the camera.
+     *        - Call publishStreamAudio:{@link #ByteRTCRoom#publishStreamAudio} to start or stop publishing the audio stream captured by the microphone.
+     *        - Call startForwardStreamToRooms:{@link #ByteRTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you called this API, the other users in the room will receive rtcRoom:onUserPublishScreenVideo:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishScreenVideo:uid:isPublish}. Those who successfully received your streams will receive rtcEngine:onFirstRemoteVideoFrameDecoded:withFrameInfo:{@link #ByteRTCRoomDelegate#rtcEngine:onFirstRemoteVideoFrameDecoded:withFrameInfo} at the same time.
+     *        - After calling this API, you'll receive rtcEngine:onScreenVideoFrameSendStateChanged:rtcUser:state:{@link #ByteRTCEngineDelegate#rtcEngine:onScreenVideoFrameSendStateChanged:rtcUser:state}.
+     *        - Refer to [Sharing Screen in PC](https://docs.byteplus.com/byteplus-rtc/docs/70144) for more information.
+     *
+     */
+    publishScreenVideo(publish: BOOL): int;
+    /** {en}
+     * @hidden(Linux)
+     * @detail api
+     * @valid since 3.60.
+     * @brief Manually publishes local screen-sharing streams in the current room. <br>
+     *        If you need to share your screen in multiple rooms, you can use the same uid to join multiple rooms and call this API in each room. Also, you can publish different types of screen-sharing streams in different rooms.
+     * @param publish Media stream type, used for specifying whether to publish audio stream or video stream.
+     * @return
+     *        - 0: Success.
+     *        - < 0 : Fail. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for more details
+     * @note
+     *        - You need to call this API to publish screen even if you set it to Auto-publish when calling joinRoom:userInfo:roomConfig:{@link #ByteRTCRoom#joinRoom:userInfo:roomConfig}.
+     *        - An invisible user cannot publish media streams. Call setUserVisibility{@link #IRTCRoom#setUserVisibility} to change your visibility in the room.
+     *        - Call publishScreenVideo:{@link #ByteRTCRoom#publishScreenVideo} to start or stop sharing the local screen.
+     *        - Call publishStreamVideo:{@link #ByteRTCRoom#publishStreamVideo} to start or stop publishing the video stream captured by the camera.
+     *        - Call publishStreamAudio:{@link #ByteRTCRoom#publishStreamAudio} to start or stop publishing the audio stream captured by the microphone.
+     *        - Call startForwardStreamToRooms:{@link #ByteRTCRoom#startForwardStreamToRooms} to forward the published streams to the other rooms.
+     *        - After you called this API, the other users in the room will receive rtcRoom:onUserPublishScreenAudio:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishScreenAudio:uid:isPublish}. Those who successfully received your streams will receive rtcEngine:onFirstRemoteAudioFrame:{@link #ByteRTCEngineDelegate#rtcEngine:onFirstRemoteAudioFrame} at the same time.
+     *        - Refer to [Sharing Screen in PC](https://docs.byteplus.com/byteplus-rtc/docs/70144) for more information.
+     *
+     */
+    publishScreenAudio(publish: BOOL): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific remote media streams captured by the local camera.  Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target video stream.
+     * @param subscribe Whether to subscribe to the stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through rtcRoom:onUserPublishStreamVideo:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishStreamVideo:uid:isPublish} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onVideoSubscribeStateChanged{@link #ByteRTCRoomDelegate#onVideoSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeStreamVideo{@link #IRTCRoom#subscribeStreamVideo}.
+     *        - Any other exceptions will be included in onVideoSubscribeStateChanged{@link #ByteRTCRoomDelegate#onVideoSubscribeStateChanged}, see SubscribeStateChangeReason{@link #SubscribeStateChangeReason} for the reasons.
+     *
+     */
+    subscribeStreamVideo(userId: NSString, subscribe: BOOL): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific remote media streams captured by the local microphone.  Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target media stream.
+     * @param subscribe Whether to subscribe to the audio stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through rtcRoom:onUserPublishStreamAudio:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishStreamAudio:uid:isPublish} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onAudioSubscribeStateChanged{@link #ByteRTCRoomDelegate#onAudioSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeStreamAudio{@link #IRTCRoom#subscribeStreamAudio}.
+     *        - Any other exceptions will be included in onAudioSubscribeStateChanged{@link #ByteRTCRoomDelegate#onAudioSubscribeStateChanged}, see ErrorCode{@link #ErrorCode} for the reasons.
+     *
+     */
+    subscribeStreamAudio(userId: NSString, subscribe: BOOL): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific screen sharing media stream. Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target screen video stream.
+     * @param subscribe Whether to subscribe to the screen video stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through rtcRoom:onUserPublishScreenVideo:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishScreenVideo:uid:isPublish} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onScreenVideoSubscribeStateChanged{@link #ByteRTCRoomDelegate#onScreenVideoSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeScreenVideo{@link #IRTCRoom#subscribeScreenVideo}.
+     *        - Any other exceptions will be included in onScreenVideoSubscribeStateChanged{@link #ByteRTCRoomDelegate#onScreenVideoSubscribeStateChanged}, see SubscribeStateChangeReason{@link #SubscribeStateChangeReason} for the reasons.
+     *
+     */
+    subscribeScreenVideo(userId: NSString, subscribe: BOOL): int;
+    /** {en}
+     * @detail api
+     * @valid since 3.60.
+     * @brief Subscribes to specific screen sharing media stream. Or update the subscribe options of the subscribed user.
+     * @param userId The ID of the remote user who published the target screen audio stream.
+     * @param subscribe Whether to subscribe to the screen audio stream.
+     * @return API call result: <br>
+     *        - 0: Success.
+     *        - <0: Failure. See ByteRTCReturnStatus{@link #ByteRTCReturnStatus} for specific reasons.
+     * @note
+     *        - Calling this API to update the subscribe configuration when the user has subscribed the remote user either by calling this API or by auto-subscribe.
+     *        - You must first get the remote stream information through rtcRoom:onUserPublishScreenAudio:uid:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishScreenAudio:uid:isPublish} before calling this API to subscribe to streams accordingly.
+     *        - After calling this API, you will be informed of the calling result with onScreenAudioSubscribeStateChanged{@link #ByteRTCRoomDelegate#onScreenAudioSubscribeStateChanged}.
+     *        - Once the local user subscribes to the stream of a remote user, the subscription to the remote user will sustain until the local user leaves the room or unsubscribe from it by calling subscribeScreenAudio{@link #IRTCRoom#subscribeScreenAudio}.
+     *        - Any other exceptions will be included in onScreenAudioSubscribeStateChanged{@link #ByteRTCRoomDelegate#onScreenAudioSubscribeStateChanged}, see SubscribeStateChangeReason{@link #SubscribeStateChangeReason} for the reasons.
+     *
+     */
+    subscribeScreenAudio(userId: NSString, subscribe: BOOL): int;
     subscribeAllStreamsWithMediaStreamType(mediaStreamType: ByteRTCMediaStreamType): int;
-    unsubscribeStream(userId: NSString, mediaStreamType: ByteRTCMediaStreamType): int;
     unsubscribeAllStreamsWithMediaStreamType(mediaStreamType: ByteRTCMediaStreamType): int;
-    subscribeScreen(userId: NSString, mediaStreamType: ByteRTCMediaStreamType): int;
-    unsubscribeScreen(userId: NSString, mediaStreamType: ByteRTCMediaStreamType): int;
     pauseAllSubscribedStream(mediaType: ByteRTCPauseResumControlMediaType): int;
     resumeAllSubscribedStream(mediaType: ByteRTCPauseResumControlMediaType): int;
     sendUserMessage(userId: NSString, message: NSString, config: ByteRTCMessageConfig): NSInteger;