add linphone_core_enter_(back/fore)ground and (un)subscribe chat room event handler when needed

coreapi/linphonecore.c

@@ -6018,6 +6018,14 @@ void friends_config_uninit(LinphoneCore* lc)
 	ms_message("Destroying friends done.");
 }
 
+void linphone_core_enter_background(LinphoneCore *lc) {
+	L_GET_CPP_PTR_FROM_C_OBJECT(lc)->enterBackground();
+}
+
+void linphone_core_enter_foreground(LinphoneCore *lc) {
+	L_GET_CPP_PTR_FROM_C_OBJECT(lc)->enterForeground();
+}
+
 LpConfig * linphone_core_get_config(const LinphoneCore *lc){
 	return lc->config;
 }

include/linphone/core.h

@@ -4026,6 +4026,18 @@ LINPHONE_PUBLIC void *linphone_core_get_user_data(const LinphoneCore *lc);
 **/
 LINPHONE_PUBLIC void linphone_core_set_user_data(LinphoneCore *lc, void *userdata);
 
+/**
+ * This method is called by the application to notify the linphone core library when it enters background mode.
+ * @ingroup misc
+ */
+LINPHONE_PUBLIC void linphone_core_enter_background(LinphoneCore *lc);
+
+/**
+ * This method is called by the application to notify the linphone core library when it enters foreground mode.
+ * @ingroup misc
+ */
+LINPHONE_PUBLIC void linphone_core_enter_foreground(LinphoneCore *lc);
+
 /**
  * Returns the LpConfig object used to manage the storage (config) file.
  * @param[in] lc #LinphoneCore object

src/conference/handlers/remote-conference-event-handler-p.h

@@ -41,6 +41,8 @@ private:
 	// CoreListener
 	void onNetworkReachable (bool sipNetworkReachable, bool mediaNetworkReachable) override;
 	void onRegistrationStateChanged (LinphoneProxyConfig *cfg, LinphoneRegistrationState state, const std::string &message) override;
+	void onEnteringBackground () override;
+	void onEnteringForeground () override;
 
 	ChatRoomId chatRoomId;
 

src/conference/handlers/remote-conference-event-handler.cpp

@@ -238,6 +238,14 @@ void RemoteConferenceEventHandlerPrivate::onRegistrationStateChanged (LinphonePr
 		subscribe();
 }
 
+void RemoteConferenceEventHandlerPrivate::onEnteringBackground () {
+	unsubscribe();
+}
+
+void RemoteConferenceEventHandlerPrivate::onEnteringForeground () {
+	subscribe();
+}
+
 // -----------------------------------------------------------------------------
 
 RemoteConferenceEventHandler::RemoteConferenceEventHandler (RemoteConference *remoteConference) :

src/conference/handlers/remote-conference-list-event-handler.cpp

@@ -245,4 +245,12 @@ void RemoteConferenceListEventHandler::onRegistrationStateChanged (LinphoneProxy
 		subscribe();
 }
 
+void RemoteConferenceListEventHandler::onEnteringBackground () {
+	unsubscribe();
+}
+
+void RemoteConferenceListEventHandler::onEnteringForeground () {
+	subscribe();
+}
+
 LINPHONE_END_NAMESPACE

src/conference/handlers/remote-conference-list-event-handler.h

@@ -61,6 +61,8 @@ private:
 	// CoreListener
 	void onNetworkReachable (bool sipNetworkReachable, bool mediaNetworkReachable) override;
 	void onRegistrationStateChanged (LinphoneProxyConfig *cfg, LinphoneRegistrationState state, const std::string &message) override;
+	void onEnteringBackground () override;
+	void onEnteringForeground () override;
 };
 
 LINPHONE_END_NAMESPACE

src/core/core-listener.h

@@ -33,6 +33,8 @@ public:
 	virtual void onGlobalStateChanged (LinphoneGlobalState state) {}
 	virtual void onNetworkReachable (bool sipNetworkReachable, bool mediaNetworkReachable) {}
 	virtual void onRegistrationStateChanged (LinphoneProxyConfig *cfg, LinphoneRegistrationState state, const std::string &message) {}
+	virtual void onEnteringBackground () {}
+	virtual void onEnteringForeground () {}
 };
 
 LINPHONE_END_NAMESPACE

src/core/core-p.h

@@ -44,6 +44,8 @@ public:
 	void notifyGlobalStateChanged (LinphoneGlobalState state);
 	void notifyNetworkReachable (bool sipNetworkReachable, bool mediaNetworkReachable);
 	void notifyRegistrationStateChanged (LinphoneProxyConfig *cfg, LinphoneRegistrationState state, const std::string &message);
+	void notifyEnteringBackground ();
+	void notifyEnteringForeground ();
 
 	int addCall (const std::shared_ptr<Call> &call);
 	bool canWeAddCall () const;
@@ -72,6 +74,8 @@ public:
 	std::unique_ptr<LocalConferenceListEventHandler> localListEventHandler;
 
 private:
+	bool isInBackground = false;
+
 	std::list<CoreListener *> listeners;
 
 	std::list<std::shared_ptr<Call>> calls;

src/core/core.cpp

@@ -113,6 +113,26 @@ void CorePrivate::notifyRegistrationStateChanged (LinphoneProxyConfig *cfg, Linp
 		listener->onRegistrationStateChanged(cfg, state, message);
 }
 
+void CorePrivate::notifyEnteringBackground () {
+	if (isInBackground)
+		return;
+
+	isInBackground = true;
+	auto listenersCopy = listeners; // Allow removable of a listener in its own call
+	for (const auto &listener : listenersCopy)
+		listener->onEnteringBackground();
+}
+
+void CorePrivate::notifyEnteringForeground () {
+	if (!isInBackground)
+		return;
+
+	isInBackground = false;
+	auto listenersCopy = listeners; // Allow removable of a listener in its own call
+	for (const auto &listener : listenersCopy)
+		listener->onEnteringForeground();
+}
+
 // =============================================================================
 
 Core::Core () : Object(*new CorePrivate) {
@@ -131,6 +151,24 @@ shared_ptr<Core> Core::create (LinphoneCore *cCore) {
 	return core;
 }
 
+// ---------------------------------------------------------------------------
+// Application lifecycle.
+// ---------------------------------------------------------------------------
+
+void Core::enterBackground () {
+	L_D();
+	d->notifyEnteringBackground();
+}
+
+void Core::enterForeground () {
+	L_D();
+	d->notifyEnteringForeground();
+}
+
+// ---------------------------------------------------------------------------
+// C-Core.
+// ---------------------------------------------------------------------------
+
 LinphoneCore *Core::getCCore () const {
 	return L_GET_C_BACK_PTR(this);
 }

src/core/core.h

@@ -71,6 +71,13 @@ public:
 	// Return a new Core instance. Entry point of Linphone.
 	static std::shared_ptr<Core> create (LinphoneCore *cCore);
 
+	// ---------------------------------------------------------------------------
+	// Application lifecycle.
+	// ---------------------------------------------------------------------------
+
+	void enterBackground ();
+	void enterForeground ();
+
 	// ---------------------------------------------------------------------------
 	// C-Core.
 	// ---------------------------------------------------------------------------