NotificationBar

Whenever VPlayMultiplayer forwards an incoming notification to be displayed by the NotificationBar, this signal is emitted.

The following example uses the signal to disable the default notification bar for chat messages and opens the chat view instead. For friend requests and game invites the notification bar will still be shown.

 VPlayMultiplayer {
   id: multiplayer

   // ...

   // use signal handler to hide notification bar for text messages and jump to chat instead
   Connections {
     target: multiplayer.notificationBar || null
     onDisplay: {
       if(additionalData.type === "text") {
         multiplayer.notificationBar.visible = false
         multiplayer.showChat(additionalData.sender, additionalData.sender_name)
       }
     }
   }
 }

To set a completely custom notification bar instead of the default one, specify your own implementation as the VPlayMultiplayer::notificationBar. Then implement the signal in your custom notification bar to show incoming notifications in the way you want.

The following example shows notifications in a native alert dialog instead of a notification bar (the actual NotificationBar item is never visible in this case):

 GameWindow {
   // ...

   VPlayMultiplayer {
     // ...
     notificationBar: myNotificationBar
   }

   NotificationBar {
     id: myNotificationBar
     onDisplay: {
       nativeUtils.displayMessageBox(additionalData.title, message, 1)
     }
   }
 }

Note: If the multiplayer chat view is opened and can display a notification directly, this signal is not fired. The notification can be consumed and visualized directly in that case. To react on all notifications regardless of the opened view or other VPlayMultiplayer settings, use the VPlayMultiplayer::notificationReceived signal instead.