zego_uikit_prebuilt_call

• fix flutter_callkit_incoming version to 3.0.0

• Fixed the issue where the offline pop-up window on the called end did not automatically disappear after the offline call was canceled by the called end

Features

• Added inviter timeout detection feature with ZegoCallRequiredInviterConfig, supporting configuration of detection rules for one-on-one/group calls. If the inviter has not joined after [detectSeconds] after entering the call, the call will be ended with ZegoCallEndReason.abandoned.

• When clicking the icon to activate the application, the offline incoming call pop-up window will automatically close.

• Fixed the issue where the second call is automatically hung up after enable ZegoCallNoResponseEndConfig.enabled .

• Automatically ending a call when there is no response in call in ZegoCallNoResponseEndConfig.timeoutSeconds seconds, default is disabled.

• Fixed the issue in the offline call scenario where the local user cannot automatically end the call when all other participants leave the room.

• Fixed the issue where Android offline incoming call handling logic would be incorrect

• Fixed the issue where third-party music being played would be interrupted during startup

Features

• Added support to disable syncing device state by SEI through the device field in ZegoCallDeviceConfig.
• Added showOnFullScreen in ZegoCallAndroidNotificationConfig. When set to true, the app will request the USE_FULL_SCREEN_INTENT permission to allow notifications to be shown in full screen on Android 14+.

Migrations

• Renamed showFullScreen to showOnLockedScreen in ZegoCallAndroidNotificationConfig, which controls whether notifications are displayed when the screen is locked.

• Support beauty plugin face detection and error event on ZegoUIKitPrebuiltCallEvents.beauty

• Update beauty to v2.x, please update new resources according to official website document

• Fixed the issue where the state of the speaker button would be reset when it appears in the More menu
• Fixed the issue where the earpiece/speaker could still be switched while using headphones

Features

• Added accidental touch prevention during earpiece calls with enableAccidentalTouchPrevention configuration option in ZegoUIKitPrebuiltCallConfig (default: true)

Configuration Requirements

• Android Permissions Required:

  <!-- Add to android/app/src/main/AndroidManifest.xml -->
  <uses-permission android:name="android.permission.WAKE_LOCK"/>
  <uses-permission android:name="android.permission.WRITE_SETTINGS" tools:ignore="ProtectedPermissions"/>
  

• Android NDK Version:

  // Add to android/app/build.gradle
  android {
      ndkVersion = "27.0.12077973"  // For Flutter 3.22.0+
      // or
      ndkVersion = "26.1.10909125"   // For Flutter 3.16.0+
  }
  

• Fixed the issue where the ringtone would sound once after the call was ended while minimized

Features

• Support export log by ZegoUIKitPrebuiltLiveStreamingController().log.export()

Bugs

• Fixed the button synchronization issue on the call invitation interface and the failure issue of earpiece/speaker switching

Update environment

Features

• Supports minimizing during an invitation, and can support customizing the UI configuration using ZegoCallInvitationInviterMinimizedUIConfig as follows

  await ZegoUIKitPrebuiltCallInvitationService().init(
    ...
    uiConfig: ZegoCallInvitationUIConfig(
      inviter: ZegoCallInvitationInviteeUIConfig(
        minimized: ZegoCallInvitationInviterMinimizedUIConfig(
          cancelButton: ZegoCallButtonUIConfig(visible: true),
          showTips: true,
        ),
      ),
      invitee: ZegoCallInvitationInviteeUIConfig(
        minimized: ZegoCallInvitationInviteeMinimizedUIConfig(
          acceptButton: ZegoCallButtonUIConfig(visible: true),
          declineButton: ZegoCallButtonUIConfig(visible: true),
          showTips: true,
        ),
      ),
    ),
  );
  

• Fixed the issue where some parameter settings in ZegoCallInvitationInviterUIConfig/ZegoCallInvitationInviteeUIConfig were ineffective

• Fixed the issue where the camera is opened during an audio call

• Added buttons on the call interface, allowing users to customize whether to turn on the camera/microphone/speaker and switch between the front and rear cameras

  await ZegoUIKitPrebuiltCallInvitationService().init(
    ...
    uiConfig: ZegoCallInvitationUIConfig(
      inviter: ZegoCallInvitationInviterUIConfig(
        useVideoViewAspectFill: true,
        showAvatar: true,
        showCentralName: true,
        showCallingText: true,
        defaultMicrophoneOn: true,
        defaultCameraOn: true,
        showMainButtonsText: true,
        showSubButtonsText: true,
      ),
      invitee: ZegoCallInvitationInviteeUIConfig(
        showAvatar: true,
        showCentralName: true,
        showCallingText: true,
        useVideoViewAspectFill: true,
        showVideoOnCalling: true,
        defaultMicrophoneOn: true,
        defaultCameraOn: true,
        showMainButtonsText: true,
        showSubButtonsText: true,
      ),
    ),
  );
  

• The location for generating iOS logs has been changed to the same directory as the Zego SDK, and the folder name has been changed to ZegoUIKits

• Fixed the issue where iOS offline calls occasionally failed to enter the call after being accepted
• Fixed the issue where the pop-up window on the invited end did not collapse after the invitation was canceled when the unauthorized system alert window permission was in effect.
• Fixed the issue where the invitationEvents.onIncomingCallReceived event had no callback
• Fixed the issue where the top/bottom toolbar remained partially visible after being hidden
• Fixed the issue where the invitation ringtone occasionally had no sound
• Fixed the issue of black screen in Android's first direct call (without invitation) video

• Fixed the issue where iOS offline calls would automatically be rejected after being declined before.

• Update dependency

• Fixed the issue where iOS offline calls would automatically be rejected after being declined before.

• Fixed the black screen issue caused by the back navigation key canceling the current call invitation pop-up window

• Fixed the issue where the menu was obscured when the navigation bar was enabled on some Android devices

• the calling page supports the video fill rendering mode. If you want the inviter's video to fill the entire screen, please set withSafeArea to false and useVideoViewAspectFill to true in the inviter's configuration.

    await ZegoUIKitPrebuiltCallInvitationService().init(
      ...
      uiConfig: ZegoCallInvitationUIConfig(
        withSafeArea: false,
        inviter: ZegoCallInvitationInviterUIConfig(
          useVideoViewAspectFill: true,
        ),
      ),
      ...
    );
  

• Rename prebuiltWithSafeArea of ZegoCallInvitationUIConfig to withSafeArea, the calling widget will also be affected by this property simultaneously

• The useSystemCallingUI has been modified to an asynchronous method, and external calls need to await to register the offline call event; otherwise, occasional issues of not receiving offline calls may occur.

  await ZegoUIKitPrebuiltCallInvitationService().useSystemCallingUI(..);
  

• Fixed the issue where the called party experiences a black screen when the caller cancels the call
• Fixed the issue of occasional failure to decline call invitations

• Update Android 14+ compatibility(force CallStyle/FOREGROUND_SERVICE_PHONE_CALL for https://developer.android.com/about/versions/14/behavior-changes-all#non-dismissable-notifications)

• Fixed the issue that the ringing sound would last for several seconds after the call was answered on some iOS devices
• Fixed issues caused by closing the call pop-up window using the back button on Android

• Fixed the issue that the caller remains on the call interface when the iOS client rejects an offline call

• Support dismiss notification in iOS, please add NSUserNotificationUsageDescription in Info.plist for iOS notification permission
• Add manuallyByUser option in ZegoCallInvitationPermission, default is false, if you want to prompt user to manually enable permissions, please add this option

Features

• Support answering offline call when lock screen on Android
• Compatible with zimkit offline logic
• Support PIP in iOS, default is open, you can set ZegoCallInvitationConfig.pip.iOS.support or ZegoUIKitPrebuiltCallConfig.pip.iOS.support to false to turn off
• Modify the in-app minimization interface
• Modify the way notifications pop up in android background mode
• Support slow-entry offline call page. When your app has some time-consuming operations that cause the automatic call page to fail (the internal jumping logic is overwritten by your page jump operation). You can call enterAcceptedOfflineCall of ZegoUIKitPrebuiltCallInvitationService and set false to autoEnterAcceptedOfflineCall of ZegoCallInvitationOfflineConfig when you enter your home page (after completing your time-consuming operations, such as login, loading data, etc.)

Bugs

• Fix the video black screen problem in calling view
• Fix the video black screen problem caused by kits mix use
• Fix the problem of init issue on android 14
• Fix the problem of occasionally not entering the call room after agreeing to offline calls on android
• Fix the issue applying beauty to other kits after exiting LIVE if using beauty on mixing multiple kits
• Fix enableCustomVideoProcessing Occasional Failure
• Fix the issue where Android PIP fails after minimizing within the app
• Fixed the issue of invitation cancel button appearing in group call
• Fix the auto cancel issue when the callee is in the in-app minimization state in group call

• when offline notification swiped away, should be regarded as refusal

• Fix the video black screen in calling view

• Fix the video black screen problem caused by kits mix use