Released: 2026-01-05 Updated: 2026-08-11
Summary: Added personal link and simulive webinar support, enhanced HWIO for companion devices, with API improvements and breaking changes.
Breaking changes
-
Enhanced SDK initialization API in file
IZRCSDK.h.-
Moved
CreateInstancemethod to the beginning of classIZRCSDKand integrated sink registration into instance creation.static IZRCSDK* CreateInstance(IZRCSDKSink* pSdkSink); -
Removed
RegisterSinkmethod from classIZRCSDK. UseCreateInstancewith sink parameter instead.
-
-
Enhanced classic whiteboard share status notification in file
IMeetingShareHelper.h.-
New added struct
ClassicWhiteboardShareStatus.struct ClassicWhiteboardShareStatus { bool isSharing = false; ///<TRUE indicates classic whiteboard is being shared, otherwise not. int32_t shareSourceID = -1; ///<Share source ID. -1 if not available. The share that the shareSourceID refers to can be pinned on confidence monitor screen. }; -
Renamed callback from
OnUpdateWhiteboardShareStatusNotificationtoOnUpdateClassicWhiteboardShareStatusNotificationin classIMeetingShareHelperSink, and changed parameter frombool isSharingtoClassicWhiteboardShareStatusstructure.virtual void OnUpdateClassicWhiteboardShareStatusNotification(const ClassicWhiteboardShareStatus& status) = 0;
-
-
Enhanced join meeting interfaces in file
IMeetingService.h.-
Renamed interface from
JoinMeetingtoJoinMeetingWithMeetingNumberin classIMeetingServicefor clarity.virtual ZRCSDKError JoinMeetingWithMeetingNumber(const std::string& meetingNumber, bool bringShareToMeeting = false) = 0; -
Removed
bringShareToMeetingparameter from interfaceJoinMeetingWithURLin classIMeetingServicebecause it is not supported.virtual ZRCSDKError JoinMeetingWithURL(const std::string& url) = 0; -
Removed
bringShareToMeetingparameter from interfaceJoinMeetingWithContactIDin classIMeetingServicebecause it is not supported.virtual ZRCSDKError JoinMeetingWithContactID(const std::string& contactID) = 0;
-
-
Enhanced HWIO feature to support Mac&Win Companion Zoom Rooms in file
IHWIOHelper.h.-
Added
companionZRIDparameter to all HWIO interfaces in classIHWIOHelper.ListHWIODevices(const std::string& companionZRID = "") ConfigureHWIODevice(const HWIODeviceConfiguration& configuration, const std::string& companionZRID = "") AssignHWIODevice(const HWIOAssignDeviceInfo& assignDevice, const std::string& companionZRID = "") IsHWIOServiceAvailable(bool& available, const std::string& companionZRID = "") SetHWIOVideoConvertPreference(const HWIOVideoConvertPreference& preference, const std::string& companionZRID = "") SetHWIOInputSignalDetection(const HWIOInputSignalDetection& signalDetection, const std::string& companionZRID = "") -
Added
companionZRIDparameter to all HWIO callbacks in classIHWIOHelperSink.OnHWIOListDevicesResult(int32_t result, const HWIOInfo& info, const std::string& companionZRID) OnHWIOConfigureDeviceResult(int32_t result, const HWIODeviceConfiguration& configuration, const std::string& companionZRID) OnHWIOAssignDeviceResult(int32_t result, const HWIOAssignDeviceInfo& assignDeviceInfo, const std::string& companionZRID) OnHWIODeviceUpdated(const HWIODeviceUpdate& deviceUpdate, const std::string& companionZRID) OnHWIOServiceStatusUpdated(bool isServiceAvailable, bool isFeatureAllowed, const std::string& companionZRID) OnHWIOSetVideoConvertPreferenceResult(int32_t result, const HWIOVideoConvertPreference& preference, const std::string& companionZRID) OnHWIOSetInputSignalDetectionResult(int32_t result, const HWIOInputSignalDetection& signalDetection, const std::string& companionZRID)
-
-
Changed field type of
defaultIndexin structCameraPresetInfofromuint32_ttoint32_tin fileZRCSDKTypes.h.struct CameraPresetInfo { int32_t defaultIndex = -1; ///<Default preset index. // ... };
Added
-
New added interfaces to support joining meeting with personal link feature.
-
New added callback in class
IMeetingServiceSinkto confirm personal link for joining meeting in fileIMeetingService.h.virtual void OnConfirmPersonalLink(const std::string& personalLink) = 0; -
New added interface in class
IMeetingServiceto join meeting with personal link name in fileIMeetingService.h.virtual ZRCSDKError JoinMeetingWithPersonalLinkName(const std::string& personalLinkName, bool bringShareToMeeting = false) = 0; -
New added interface in class
IMeetingServiceto join meeting using a complete personal link in fileIMeetingService.h.virtual ZRCSDKError JoinMeetingWithPersonalLink(const std::string& personalLink) = 0; -
New added interface in class
IMeetingServiceto cancel confirming personal link in fileIMeetingService.h.virtual ZRCSDKError CancelConfirmPersonalLink() = 0;
-
-
New added interfaces to support simulive webinar feature.
-
New added struct
SimuliveWebinarInfoin fileIMeetingWebinarHelper.h.struct SimuliveWebinarInfo { bool isInSimuliveStatus = false; ///<TRUE indicates it is currently in simulive status, otherwise not. time_t recordingEndTimeStampInSecond = 0; ///<The recording end time stamp, it is valid when the isInSimuliveStatus is true. }; -
New added callback in class
IMeetingWebinarHelperSinkto notify simulive webinar info in fileIMeetingWebinarHelper.h.virtual void OnSimuliveWebinarInfoNotification(const SimuliveWebinarInfo& info) = 0; -
New added interface in class
IMeetingWebinarHelperto transition simulive webinar to live session in fileIMeetingWebinarHelper.h.virtual ZRCSDKError SimuliveWebinarGoLive() = 0; -
New added enum value
CONSENT_TYPE_SIMULIVE_WEBINARin enumConsentTypein fileIMeetingReminderHelper.h. -
New added enum value
CONSENT_TYPE_CUSTOM_RECORDINGin enumConsentTypein fileIMeetingReminderHelper.h. -
New added fields in struct
MeetingInfoin fileZRCSDKTypes.h.struct MeetingInfo { // ... bool isSimuliveWebinar = false; ///<TRUE indicates the meeting is simulive webinar, otherwise not. bool isSimuliveWebinarSupportGoLive = false; ///<TRUE indicates the simulive webinar supports go live, otherwise not. bool isSimuliveWebinarAllowGoLive = false; ///<TRUE indicates the simulive webinar is allowed go live, otherwise not. }; -
New added fields in struct
MeetingParticipantin fileZRCSDKTypes.h.struct MeetingParticipant { // ... bool isSimuliveUser = false; ///<TRUE indicates the user is simulive user, otherwise not. bool isActiveSimuliveUser = false; ///<TRUE indicates the user is simulive user that is playing recording, otherwise not. }; -
New added error code
ZRCSDKERR_API_NOT_SUPPORT_IN_SIMULIVE_WEBINARin fileZRCSDKTypes.h. -
New added error code
ZRCSDKERR_USER_IS_SIMULIVE_USERin fileZRCSDKTypes.h.
-
-
New added interfaces to support system audio enhancements feature in file
ISettingService.h.-
New added enum
SystemAudioEnhancementsMode.enum SystemAudioEnhancementsMode { SystemAudioEnhancementsModeNone = -1, ///<System audio enhancements mode is None, indicates the system audio enhancements feature is not available. SystemAudioEnhancementsModeAuto = 0, ///<System audio enhancements mode is Auto. SystemAudioEnhancementsModeOn, ///<System audio enhancements mode is On. SystemAudioEnhancementsModeOff ///<System audio enhancements mode is Off. }; -
New added callback in class
ISettingServiceSinkto notify system audio enhancements mode update.virtual void OnUpdateSystemAudioEnhancementsMode(SystemAudioEnhancementsMode mode) = 0; -
New added interface in class
ISettingServiceto get current system audio enhancements mode.virtual ZRCSDKError GetCurrentSystemAudioEnhancementsMode(SystemAudioEnhancementsMode& mode) = 0; -
New added interface in class
ISettingServiceto select system audio enhancements mode.virtual ZRCSDKError SelectSystemAudioEnhancementsMode(SystemAudioEnhancementsMode mode) = 0;
-
-
New added fields in struct
MeetingParticipantto support RTMP user in fileZRCSDKTypes.h.struct MeetingParticipant { // ... bool isRTMPUser = false; ///<TRUE indicates user is RTMP (Real Time Messaging Protocol) user, otherwise not. bool isActiveRTMPUser = false; ///<TRUE indicates user is current active RTMP user, otherwise not. }; -
New added field in struct
Deviceto support stethoscope microphone in fileZRCSDKTypes.h.struct Device { // ... bool isStethoscopeMic = false; ///<TRUE indicates device is a stethoscope microphone, otherwise not. }; -
New added error codes in file
ZRCSDKTypes.h.ZRCSDKERR_CANNOT_PIN_THE_SHARE_ON_CONFIDENCE_MONITOR_SCREEN- The share can’t be pinned on confidence monitor screen.ZRCSDKERR_USER_UNSUPPORTED_ACTION- The user unsupported action.
-
New added enum value
ExitMeetingReasonRejoinNewMeetingin enumExitMeetingReasonto indicate exit meeting reason is rejoin new meeting in fileIMeetingService.h.
Changed
- Enhanced interface
ReportIssuein classIParticipantHelperto support report in waiting room in fileIParticipantHelper.h. In this case,userIDscan be empty.
Deprecated
- Deprecated interface
UpdateVideoLayoutStylein classIMeetingViewLayoutHelperin fileIMeetingViewLayoutHelper.h. Please useSetScreenLayout(MeetingScreen screenIndex, ScreenLayoutSourceType layout)instead.