{"id":31868,"date":"2024-11-01T09:03:39","date_gmt":"2024-11-01T09:03:39","guid":{"rendered":"http:\/\/atmokpo.com\/w\/?p=31868"},"modified":"2024-11-01T11:34:21","modified_gmt":"2024-11-01T11:34:21","slug":"basic-unity-course-displaying-the-network-room-list","status":"publish","type":"post","link":"https:\/\/atmokpo.com\/w\/31868\/","title":{"rendered":"Basic Unity Course: Displaying the Network Room List"},"content":{"rendered":"

<\/p>\n

1. Introduction<\/h2>\n

In game development, multiplayer features provide a variety of experiences. In this tutorial, we will learn how to display a network room list using Unity. This tutorial is written for beginners and is based on an understanding of basic Unity usage and C# programming.<\/p>\n

2. Unity and Networking<\/h2>\n

Unity offers various networking solutions. UNet (Unity Network) is one of them, useful for setting up basic multiplayer environments. As of Unity 2020.1, UNet has been deprecated, and the new networking framework MLAPI has been introduced. This tutorial will focus on MLAPI.<\/p>\n

3. Preparation<\/h2>\n

3.1. Installing Unity<\/h3>\n

To install Unity, download Unity Hub and install the desired version of Unity. MLAPI is supported on Unity version 2019.4 and above.<\/p>\n

3.2. Adding the MLAPI Package<\/h3>\n

To add MLAPI to your project, use the Unity Package Manager. In the Unity editor, select ‘Window’ -> ‘Package Manager’, then select ‘Add package from git URL…’ and enter https:\/\/github.com\/Unity-Technologies\/Mirror.git<\/code>.<\/p>\n

4. Creating a New Unity Project<\/h2>\n

Create a new Unity project and select the 3D template. Once the project is created, you will be ready to add all necessary assets and networking-related scripts.<\/p>\n

5. Setting Up the Scene<\/h2>\n

Create a new scene and add a basic camera and lighting. Add a skybox and a few 3D objects to create a test environment.<\/p>\n

6. Adding a Network Manager<\/h2>\n

To manage the network, add a NetworkManager<\/code> component to the scene. The NetworkManager<\/code> is responsible for creating and managing network rooms. After creating the game object, set it up as follows:<\/p>\n

NetworkManager manager = gameObject.AddComponent<NetworkManager>();<\/code><\/pre>\n
7. Setting Up UI to Display Room List<\/h2>\n
7.1. Adding UI Elements<\/h3>\n
To display the room list in the UI, add a Canvas<\/code> and use Text<\/code> and Button<\/code> elements to construct the UI that will display the room list.<\/p>\n
7.2. Writing UI Scripts<\/h3>\n
Write a script to display the room list. Below is an example of the basic code to retrieve room information.<\/p>\n
\nusing UnityEngine;\nusing UnityEngine.UI;\nusing UnityEngine.Networking;\nusing System.Collections.Generic;\n\npublic class RoomList : MonoBehaviour\n{\n    public GameObject roomButtonPrefab;\n    public Transform roomListContainer;\n\n    void Start()\n    {\n        NetworkManager.singleton.OnMatchList += OnMatchList;\n        NetworkManager.singleton.ListMatches(0, 20, \"\", OnMatchList);\n    }\n\n    void OnMatchList(bool success, string extendedInfo, List matches)\n    {\n        foreach (Transform child in roomListContainer)\n        {\n            Destroy(child.gameObject);\n        }\n\n        if (success)\n        {\n            foreach (var match in matches)\n            {\n                Instantiate(roomButtonPrefab, roomListContainer).GetComponentInChildren().text = match.name;\n            }\n        }\n    }\n}\n<\/text><\/matchinfosnapshot><\/code><\/pre>\n
8. Creating a Room<\/h2>\n
Additional functionality is needed to allow users to create a room by clicking a button. Implement room creation by adding the following function.<\/p>\n
\npublic void CreateRoom()\n{\n    NetworkManager.singleton.StartMatchMaker();\n    NetworkManager.singleton.matchMaker.CreateMatch(\"RoomName\", 2, true, \"\", \"\", \"\", 0, 0, OnMatchCreate);\n}\n\nvoid OnMatchCreate(bool success, string extendedInfo, MatchInfo match)\n{\n    if (success)\n    {\n        NetworkManager.singleton.StartHost();\n    }\n}\n<\/code><\/pre>\n
9. Joining a Room<\/h2>\n
Add a UI button to allow users to join a room and implement the functionality to join a room with the following code.<\/p>\n
\npublic void JoinRoom(MatchInfoSnapshot match)\n{\n    NetworkManager.singleton.StartMatchMaker();\n    NetworkManager.singleton.matchMaker.JoinMatch(match.networkId, \"\", OnMatchJoin);\n}\n\nvoid OnMatchJoin(bool success, string extendedInfo, MatchInfo match)\n{\n    if (success)\n    {\n        NetworkManager.singleton.StartClient();\n    }\n}\n<\/code><\/pre>\n
10. Testing and Debugging<\/h2>\n
Once all scripts and UI are complete, test the multiplayer functionality in the Unity editor. Create a room and check the room list from another client to verify everything is working correctly.<\/p>\n
11. Conclusion<\/h2>\n
This tutorial taught you how to display a network room list in Unity. Additional features such as room deletion, modifying room information, and UI improvements can provide a better user experience. We plan to continue covering in-depth topics on Unity and networking.<\/p>\n
12. References<\/h2>\n