17.0

    <!-- Load help lightning JS SDK -->
    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <script src="https://helplightning.net/sdk/5.14.2/helplightning.min.js"></script>
    <script src="https://helplightning.net/sdk/5.14.2/opentok-enterprise/opentok.min.js"></script>
    <script src="https://helplightning.net/sdk/5.14.2/pdf_viewer/build/pdf.min.js"></script>

{
    'sessions': Session[]
}

{
    'sessionId': String
}

{
    'minimize': Boolean
}

/**
 The dictionary key for the app group name of the screen sharing
 */
extern NSString* const kHLCallPluginScreenSharingAppGroupName;

/**
 The dictionary key for the bundle id of the screen sharing broadcast extension
 */
extern NSString* const kHLCallPluginScreenSharingBroadcastExtensionBundleId;

/// The call needs the screen sharing information to start screen sharing
/// - Parameter call: the current call
/// - Returns: A dictionary with the screen sharing information, which should include ``kHLCallPluginScreenSharingAppGroupName`` and ``kHLCallPluginScreenSharingBroadcastExtensionBundleId``. If the dictionary is empty, the call will not show the screen sharing option in the share menu.
- (NSDictionary<NSString*, id>*)hlCallNeedScreenSharingInfo:(id<HLGenericCall>)call;

extern NSString *const kHLImageShareMenuScreenSharing;
extern NSString *const kHLImageShareMenuScreenSharingSelected;
extern NSString *const kHLImageShareMenuFaceToFace;
extern NSString *const kHLImageShareMenuFaceToFaceSelected;

@interface HLCall : NSObject <HLGenericCall>

// Set this new property to YES to allow Merge Reality Plus. Set it to NO to disable Merge Reality Plus
// The default value is YES.
@property (nonatomic) BOOL mergeRealityPlusAllowed;

/// Determine if the app supports to minimize the call view
/// - Parameter call: the current ongoging call
/// - Parameter call: the information to minimize the call view. The available keys are kHLCallPluginWorkspaceId, kHLCallPluginCallWorkboxId, kHLCallInfoSessionID, kHLCallPluginCallWorkboxId, kHLCallPluginCallContentView. But these keys are optional
/// - Returns: a Promise which should be fulfilled with ``@YES`` when the app supports to minimize the call view. If the promise is fulfilled with ``@NO``, the call will not show the call minimize button on the action bar.
- (FBLPromise*) hlCall:(id<HLGenericCall>)call canMinimizeCallViewWithCallInfo:(NSDictionary<NSString*, id>*)callInfo;

/// Request the app minimize the call view
/// - Parameter call: the current ongoging call
/// - Parameter callInfo: the information to minimize the call view. The available keys are kHLCallInfoPresentingViewController,  kHLCallPluginWorkspaceId, kHLCallPluginCallWorkboxId, kHLCallInfoSessionID, kHLCallPluginCallWorkboxId, kHLCallPluginCallContentView. But these keys are optional
/// - Returns: a Promise which should be fulfilled when the app minimize the call. If the promise is rejected, the app fails to minimize the call view.
- (FBLPromise*) hlCall:(id<HLGenericCall>)call didMinimizeCallViewWithCallInfo:(NSDictionary<NSString*, id>*)callInfo;

/// will restore minimize the call view
/// - Parameter call: the current ongoging call
/// - Parameter callInfo: the information to minimize the call view. The available keys are kHLCallInfoPresentingViewController,  kHLCallPluginWorkspaceId, kHLCallPluginCallWorkboxId, kHLCallInfoSessionID, kHLCallPluginCallWorkboxId, kHLCallPluginCallContentView. But these keys are optional
/// - Returns: a Promise which should be fulfilled when the app minimize the call. If the promise is rejected, the app fails to minimize the call view.
- (FBLPromise*) hlCall:(id<HLGenericCall>)call willRestoreCallViewWithCallInfo:(NSDictionary<NSString*, id>*)callInfo;

/// did restore minimize the call view
/// - Parameter call: the current ongoging call
/// - Parameter callInfo: the information to minimize the call view. The available keys are kHLCallInfoPresentingViewController,  kHLCallPluginWorkspaceId, kHLCallPluginCallWorkboxId, kHLCallInfoSessionID, kHLCallPluginCallWorkboxId, kHLCallPluginCallContentView. But these keys are optional
- (void) hlCall:(id<HLGenericCall>)call didRestoreCallViewWithCallInfo:(NSDictionary<NSString*, id>*)callInfo;

/// a call did capture a photo
/// - Parameters:
///   - call: the call
///   - imageData: the image data
///   - mimeType: the mime type of the image data
- (void) hlCall:(id<HLGenericCall>)call didCaptureImage:(NSData*)imageData mimeType:(NSString*)mimeType;

HLCall call = new HLCall.Builder()
    .sessionId("your-session-id")
    .sessionToken("your-session-token")
    .userToken("your-user-token")
    .gssUrl("your-gss-url")
    .localUserDisplayName("your-display-name")
    .localUserAvatarUrl("your-avatar-url")
    .helplightningAPIKey("your-api-key")
    .autoEnableCamera(true)
    .autoEnableMicrophone(true)
    .autoEnableAudioPlusMode(false)
    .startInMiniView(false)
    .build();

public static class CallClientDelegateConstants {
    ...
    public const string BroadcastExtensionBundleId = "BroadcastExtensionBundleId";
    public const string BroadcastExtensionAppGroupName = "BroadcastExtensionAppGroupName";
}

/// <summary>
/// The main app should implement this method to provide information to enable screen sharing
/// </summary>
/// <param name="call">The current call</param>
/// <returns>
/// The delegate method should return a dictionary with two entries:
/// The value of <see cref="CallClientDelegateConstants.BroadcastExtensionAppGroupName"/> should be the App Group for the broadcast extension.
/// The value of <see cref="CallClientDelegateConstants..BroadcastExtensionBundleId"/> should be the broadcast extension's bundle id.
/// </returns>
IDictionary<string, object> CallNeedScreenSharingInfo(Call call);

/// <summary>
/// Determine if the app supports to minimize the call view
/// </summary>
/// <param name="call">The current ongoging call</param>
/// <param name="callInfo">The information to minimize the call view.</param>
/// <returns>A task which should be fulfilled with true when the app supports to minimize the call view.
/// If the task is fulfilled with false, the call will not show the call minimize button on the action bar.</returns>
Task<bool> CallCanMinimizeCallViewWithCallInfo(Call call, IDictionary<string, object> callInfo);

/// <summary>
/// Request the app to show the minimized call view
/// </summary>
/// <param name="call">The current ongoging call</param>
/// <param name="callInfo">The information to minimize the call view. App can get the mini call view from the key: CallPluginCallContentView</param>
/// <returns>A task which should be fulfilled when the app minimizes the call. If the app fails to minimize the call view, the promise shoud be rejected.</returns>
Task<bool> CallDidMinimizeCallViewWithCallInfo(Call call, IDictionary<string, object> callInfo);

/// <summary>
/// Notify the app when the full call view will be restored. The mini call view should be removed from the UI hierachy.
/// </summary>
/// <param name="call">The current ongoging call</param>
/// <param name="callInfo">The information to minimize the call view. App can get the mini call view from the key: CallPluginCallContentView</param>
/// <returns>A task which should be fulfilled when the app remove the mini callview. If the app fails to remove the mini call view, the promise shoud be rejected.</returns>
Task<bool> CallWillRestoreCallViewWithCallInfo(Call call, IDictionary<string, object> callInfo);

/// <summary>
/// The call view has been restored from the mini call view.
/// </summary>
/// <param name="call">The current ongoging call</param>
/// <param name="callInfo">The information to minimize the call view</param>
void CallDidRestoreCallViewWithCallInfo(Call call, IDictionary<string, object> callInfo);

/// <summary>
/// When a photo is captured from the call.
/// </summary>
/// <param name="call">The current ongoging call</param>
/// <param name="imageData">The image data. The data generally can be used to create an UIImage instance</param>
/// <param name="mimeType">The image type</param>
void CallDidCaptureImage(Call call, byte[] imageData, string mimeType);

/// <summary>
/// The flag to Allow Merge Reality+ in the call. The default value is true. This flag only works on iOS
/// </summary>
/// <remarks>
/// If true, allow Merge Reality+ in the call
/// If false, disable Merge Reality+ in the call.
/// </remarks>
/// <value>Automatically enable microphone</value>
public bool MergeRealityPlusAllowed { get; }

//17.0 iOS Icons
public const string ImageShareMenuScreenSharingIOS = "image_share_menu_screen_sharing";
public const string ImageShareMenuScreenSharingSelectedIOS = "image_share_menu_screen_sharing_selected";
public const string ImageShareMenuFaceToFaceIOS = "image_share_menu_face_to_face";
public const string ImageShareMenuFaceToFaceSelectedIOS = "image_share_menu_face_to_face_selected";

/// <summary>
/// Check if the app can support to minimized a call view
/// </summary>
/// <param name="call">the call information</param>
/// <returns>true if the app supports to minimize the call view. </returns>
bool IsMinimizeCallEnabled(Call call);

AndroidX.Lifecycle.LiveData GetMinimizedCall();

void ReturnToActiveCall();

void EndActiveCall(AndroidX.Fragment.App.FragmentActivity context);

bool IsCallMinimized();

public override View OnCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
{
    ...

    CallClientFactory.Instance.CallClient.GetMinimizedCall().Observe(ViewLifecycleOwner, new MiniCallViewObserver(this));
...
}

private class OngoingCallListener : Java.Lang.Object, IOngoingCallListener
{
    JoinSession self;
    internal OngoingCallListener(JoinSession self)
    {
        this.self = self;
    }
    public void OnEndCall()
    {
        CallClientFactory.Instance.CallClient.EndActiveCall(self.Activity);
    }
     public void OnMaximizeCall()
    {
        CallClientFactory.Instance.CallClient.ReturnToActiveCall();
    }
}

private class MiniCallViewObserver : Java.Lang.Object, IObserver
{
    JoinSession self;
    internal MiniCallViewObserver(JoinSession self)
    {
        this.self = self;
    }

    public void OnChanged(Java.Lang.Object value)
    {
        if (value != null && value is OngoingCallInfo callInfo)
        {
            self.ongoingCallMiniView.SetCallInfo(callInfo.MiniView, callInfo.CallTitle);
        }
        else
        {
            self.ongoingCallMiniView.SetCallInfo(null, null);
        }
    }
}