Meta Developers

The Multiplayer Test Cases below cover Multiplayer scenarios that should all be supported for all apps in Meta Quest. While not a requirement at this time, this is the level of comfortable gameplay that Meta holds for any multiplayer game.

This grid describes the Join Intent Payload (across) and the App State (down).

	Empty	Destination Only	Destination & Lobby Session	Destination & Match Session	Destination & Lobby Session & Match Session
App just launched	Normal App Launch	Take User to Destination. Set presence to destination	Take User to Destination in the same instance as other players with the same lobby session id. Set Presence to Destination & Lobby Session ID	Take User to Destination in the same instance as other players with the same match session id Set Presence to Destination & Match Session ID	Take User to Destination in the same instance as other players with the same lobby & match session id. Set Presence to Destination & Lobby Session ID & Match Session ID
App is currently running	Nothing	Take User to Destination. Set presence to destination	Take User to Destination in the same instance as other players with the same lobby session id. Set Presence to Destination & Lobby Session ID	Take User to Destination in the same instance as other players with the same match session id Set Presence to Destination & Match Session ID	Take User to Destination in the same instance as other players with the same lobby & match session id Set Presence to Destination & Lobby Session ID & Match Session ID
User hasn’t done tutorial, but tutorial is skippable	N/A	Take User to Destination. Set presence to destination	Take User to Destination in the same instance as other players with the same lobby session id Set Presence to Destination & Lobby Session ID	Take User to Destination in the same instance as other players with the same match session id Set Presence to Destination & Match Session ID	Take User to Destination in the same instance as other players with the same lobby & match session id Set Presence to Destination & Lobby Session ID & Match Session ID
User hasn’t done tutorial and tutorial is mandatory	N/A	Inform the user they must do the tutorial first then take them to the destination once they complete	Inform the user they must do the tutorial first. Then take them to the destination & lobby session once they complete. Set Presence to Destination & Lobby Session ID	Inform the user they must do the tutorial first. Then take them to the destination & match session once they complete Set Presence to Destination & Match Session ID	Inform the user they must do the tutorial first. Then take them to the destination & lobby & match session once they complete. Set Presence to Destination & Lobby Session ID & Match Session ID
Instance for lobby session ID does not exist	N/A	N/A	Create an instance for the provided lobby session id. Take user to the destination for that instance. Other players with the same destination & lobby session id should end up in this instance. Set Presence to Destination and Lobby Session ID	N/A	Create an instance for the provided lobby session id. Take user to the destination for that instance. Other players with the same destination and lobby session id should end up in this instance. Set Presence to Destination and Lobby Session ID & Match Session ID
Instance for match session ID does not exist	N/A	N/A	N/A	Create an instance for the provided match session id. Take user to the destination for that instance. Other players with the same destination & match session id should end up in this instance Set Presence to Destination & Match Session ID	Create an instance for the provided match session id. Take user to the destination for that instance. Other players with the same destination & match session id should end up in this instance. Set Presence to Destination & Lobby Session ID & Match Session ID
User does not have access to that destination	N/A	Show an error message to the user that they cannot reach the destination and have them take appropriate action to get access depending on the requirements: - Be a higher level - Buy DLC - Upgrade the app to the latest version	Show an error message to the user that they cannot reach the destination and have them take to appropriate action to get access depending on the requirements: - Be a higher level - Buy DLC - Upgrade the app to the latest version	Show an error message to the user that they cannot reach the destination and have them take to appropriate action to get access depending on the requirements: - Be a higher level - Buy DLC - Upgrade the app to the latest version	Show an error message to the user that they cannot reach the destination and have them take to appropriate action to get access depending on the requirements: - Be a higher level - Buy DLC - Upgrade the app to the latest version
Lobby is full or unjoinable for current user	N/A	N/A	Show an error message and inform the user on why they cannot join: - The lobby is full - The user is not allowed to join If the user has been invited by someone currently in the lobby, inform that person N/A	Show an error message and inform the user on why they cannot join the lobby. - The session is full - The user is not allowed to join If the user is allowed to join a different lobby, but for the same match, ask if the user wishes to do so. Set the user presence that lobby & match session ID & destination.
Match has already started and cannot be joined in progress	N/A	Do not have users join matches in progress for the destination.	Show an error message that the user that the match has already started and thus the lobby isn’t joinable. Alternatively, if there’s a waiting area for players to wait or spectate while in the lobby, put the user in the lobby and in the waiting & spectating mode until the match is over. Set the user’s presence to the destination & lobby session id.	Show an error message that the user that the match has already started and thus isn’t joinable. Alternatively, if there’s a waiting area for players to wait or spectate, put the user in the waiting & spectating mode until the match is over. Set the user’s presence to the destination.	Show an error message that the user that the match has already started and thus the lobby isn’t joinable. Alternatively, if there’s a waiting area for players to wait or spectate while in the lobby, put the user in the lobby and in the waiting & spectating mode until the match is over. Set the user’s presence to the destination & lobby session id.
Match is full or unjoinable for current user	N/A	N/A	If there’s a waiting area for players to wait or spectate while in the lobby even if the match isn’t joinable, put the user in the lobby and in the waiting & spectating mode until the match is over. Set the user’s presence to the destination & lobby session id.	Show an error message and inform the user on why they cannot join: - The match is full - The user is not allowed to join If the user is allowed to spectate, put the user on the spectator list. If the user can join after the match is over, inform the user they can join after the match is over and place them into a lobby session with other players from that match.	Show an error message and inform the user on why they cannot join: - The match is full - The user is not allowed to join If the user is allowed to spectate, put the user on the spectator list. If the user can join after the match is over, inform the user they can join after the match is over and place them into a lobby session with other players from that match.
User’s app has crash and they are relaunching the app. They were in a destination / lobby / match right before the crash.	N/A	Take User to Destination. Set presence to destination	Take User to Destination in the same instance as other players with the same lobby session id. If the lobby matches the ones they were in right before the crash, have them be able to rejoin even if under normal circumstances other players are not allowed to join in at the time. Set Presence to Destination & Lobby Session ID	Take User to Destination in the same instance as other players with the same match session id If the match matches the ones they were in right before the crash, have them be able to rejoin even if under normal circumstances other players are not allowed to join in at the time. Set Presence to Destination & Match Session ID	Take User to Destination in the same instance as other players with the same lobby & match session id If the lobby & match matches the ones they were in right before the crash, have them be able to rejoin even if under normal circumstances other players are not allowed to join in at the time. Set Presence to Destination & Lobby Session ID & Match Session ID
Network failed to establish connection	N/A	Inform the user, and ask if they wish to try again	Inform the user, and ask if they wish to try again	Inform the user, and ask if they wish to try again	Inform the user, and ask if they wish to try again