This document is about: PUN 1
SWITCH TO

PUN Classic (v1)、PUN 2 和 Bolt 處於維護模式。 PUN 2 將支援 Unity 2019 至 2022,但不會添加新功能。 當然,您所有的 PUN & Bolt 專案可以用已知性能繼續運行使用。 對於任何即將開始或新的專案:請切換到 Photon Fusion 或 Quantum。

2 - Lobby UI

This part will focus on creating the User Interface (UI) for the lobby.
It's going to stay very basics, as it's not really related to Networking per say.

The Play Button

Currently, our lobby is automatically connecting us to a room, that was good for the early testing, but really we want to let the User choose if and when to start playing.
So we'll simply provide a button for that.

  1. Open the scene Launcher.
  2. Create a UI Button using the Unity menu 'GameObject/UI/Button', name that button Play Button
    Notice it created a Canvas and an EventSystem GameObject in the Scene Hierarchy, so we don't have to, nice :)
  3. Edit the child Text value of the Play Button to "Play"
  4. Select Play Button and locate the On Click () section inside the Button Component
  5. Click on the small '+' to add an entry
  6. Drag the Launcher GameObject from the Hierarchy into the Field
  7. Select in the drop-down menu Launcher.Connect()
    We have now connected the Button with our Launcher Script, so that when the user press that Button, it will call the method "Connect()" from our Launcher Script.
  8. Open the Script Launcher.
  9. Remove in the Start() the line where we call Connect()
  10. Save the Script Launcher and save the Scene as well.

If you hit play now, notice you won't be connecting until you hit the Button.

The Player Name

One other important minimal requirement for typical games is to let users input their names so that other players know whom they are playing against.
We'll add a twist to this simple task, by using PlayerPrefs to remember the value of the Name so that when the user opens the game, we can recover what was the name.
It's a very handy and quite important feature to implement in many areas of your game for a great User Experience.

Let's first create the script that will manage and remember the Player's name and then create the related UI.

Creating the PlayerNameInputField

  1. Create a new C# Script, call it PlayerNameInputField

  2. Here is the full content of it. Edit and save PlayerNameInputField script accordingly:

    C#

    using UnityEngine;
    using UnityEngine.UI;
    
    using System.Collections;
    
    namespace Com.MyCompany.MyGame
    {
        /// <summary>
        /// Player name input field. Let the user input his name, will appear above the player in the game.
        /// </summary>
        [RequireComponent(typeof(InputField))]
        public class PlayerNameInputField : MonoBehaviour
        {
            #region Private Variables
    
            // Store the PlayerPref Key to avoid typos
            static string playerNamePrefKey = "PlayerName";
    
            #endregion
    
            #region MonoBehaviour CallBacks
    
            /// <summary>
            /// MonoBehaviour method called on GameObject by Unity during initialization phase.
            /// </summary>
            void Start () {
    
                string defaultName = "";
                InputField _inputField = this.GetComponent<InputField>();
                if (_inputField!=null)
                {
                    if (PlayerPrefs.HasKey(playerNamePrefKey))
                    {
                        defaultName = PlayerPrefs.GetString(playerNamePrefKey);
                        _inputField.text = defaultName;
                    }
                }
    
                PhotonNetwork.playerName =  defaultName;
            }
    
            #endregion
    
            #region Public Methods
    
            /// <summary>
            /// Sets the name of the player and save it in the PlayerPrefs for future sessions.
            /// </summary>
            /// <param name="value">The name of the Player</param>
            public void SetPlayerName(string value)
            {
                // #Important
                PhotonNetwork.playerName = value + " "; // force a trailing space string in case value is an empty string, else playerName would not be updated.
    
                PlayerPrefs.SetString(playerNamePrefKey,value);
            }
    
            #endregion
        }
    }
    

Let's analyze this script:

  • RequireComponent(typeof(InputField))
    We first make sure that this script enforces the InputField because we need this, it's a very convenient and fast way to guarantee trouble-free usage of this script.

  • PlayerPrefs.HasKey(), PlayerPrefs.GetString() and PlayerPrefs.SetString()
    PlayerPrefs is a simple lookup list of paired entries (like an excel sheet with two columns), one is the key, on is the Value.
    The Key is a string and is totally arbitrary, you decide how to name and you will need to stick to it throughout the development.
    Because of that, it makes sense to always store your PlayerPrefs Keys in one place only, a convenient way is to use a [Static| variable declaration, because it won't change over time during the game and is the same every time. One could go all the way and declare it Const, but this is something you'll get into as you gain more and more experience with C#, this is just teasing with the C# scope of possibilities here.

    So, the logic is very straightforward.
    If the PlayerPrefs has a given key, we can get it and inject that value directly when we start the feature, in our case we fill up the InputField with this when we start up and during editing, We set the PlayerPref Kea with the current value of the InputField and we are then sure it's been stored locally on the User device for later retrieval ( the next time the user will open this game).

  • PhotonNetwork.playerName
    This is the main point of this script, setting up the name of the player over the network.
    The script uses this in two places, once during Start() after having check if the name was stored in the PlayerPrefs and inside the public method SetPlayerName().
    Right now, nothing is calling this method, we need to bind the InputField OnValueChange() to call SetPlayerName() so that every time the user is editing the InputField, we record it.
    We could do this only when the user is pressing play, this is up to you, however, this is a bit more involving script-wise, so let's keep it simple for the sake of clarity.
    It also means that no matter what the user will do, the input will be remembered, which is often the desired behavior.

Creating the UI for the Player's Name

  1. Make sure you are still in the scene Launcher.
  2. Create a UI InputField using the Unity menu 'GameObject/UI/InputField', name that GameObject Name InputField
  3. Set the PosY value within the RectTransform to 35 so it sits above the Play Button
  4. Locate the PlaceHolder child of Name InputField and set it's Text Value to "Enter your Name..."
  5. Select Name InputField GameObject
  6. Add the PlayerNameInputField Script we've just created to it
  7. locate the On Value Change (String) section inside the InputField Component
  8. Click on the small '+' to add an entry
  9. Drag the PlayerNameInputField component attached to the same GameObject into the field
PlayerName InputField's OnValueChange action
PlayerName InputField's OnValueChange action
  1. Select in the drop-down menu the PlayerNameInputField.SetPlayerName() under Dynamic String section
  2. Save the Scene

Now you can hit play, input your name and stop playing, hit play again, the input that you've entered just showed up.

We are getting there, however in terms of User Experience we're missing feedback on the connection progress as well as when something goes wrong during connection and when joining rooms.

The Connection Progress

We are going to keep it simple here and hide away the name field and play button and replace it with a simple text "Connecting..." during connection and switch it back when needed.

To do so, we are going to group the Play Button and name Field so that we simply activate and deactivate that group.
Later on, more features can be added to the group and it will not affect our logic.

  1. Make sure you are still in the scene Launcher.
  2. Create a UI Panel using the Unity menu 'GameObject/UI/Panel', name that GameObject Control Panel
  3. Delete the Image and Canvas Renderer component from the Control Panel, we don't need any visuals for this panel, we only care about its content.
  4. drag and drop the Play Button and Name InputField onto the Control Panel
  5. Create a UI Text using the Unity menu 'GameObject/UI/Text', name that GameObject Progress Label don't worry about it interfering visually, we'll activate/deactivate them accordingly at runtime.
  6. Select the Text Component of Progress Label
  7. Set Alignment to be center align and middle align
  8. Set Text value to "Connecting..."
  9. Set Color to white or whatever stands out from the background.
  10. Save the Scene

At this point, for testing, you can simply enable/disable Control Panel and Progress Label to see how things will look during the various connection phases.
Let's now edit the scripts to control these two GameObjects activation.

  1. Edit the Script Launcher

  2. Add the two following properties within the Public Properties Region

    C#

    [Tooltip("The Ui Panel to let the user enter name, connect and play")]
    public GameObject controlPanel;
    [Tooltip("The UI Label to inform the user that the connection is in progress")]
    public GameObject progressLabel;
    
  3. Add to the Start() method the following

    C#

    progressLabel.SetActive(false);
    controlPanel.SetActive(true);
    
  4. Add at the beginning of Connect() method the following

    C#

    progressLabel.SetActive(true);
    controlPanel.SetActive(false);
    
  5. Add to the beginning of OnDisconnectedFromPhoton() method the following

    C#

    progressLabel.SetActive(false);
    controlPanel.SetActive(true);
    
  6. Save the Script Launcher and wait for Unity to finish compiling

  7. Make sure you are still in the scene Launcher.

  8. Select the GameObject Launcher in the Hierarchy

  9. Drag and Drop from the Hierarchy Control Panel and Progress Label to their respective Field within the Launcher Component

  10. Save the Scene

Now, if you play the scene.
You'll be presented with just the Control Panel, visible and as soon as you click Play, the Progres Label will be shown.

For now, we're good for the lobby part. In order to further add features to the lobby, we need to switch to the Game itself and create the various scenes so that we can finally load the right level when we join a room. We'll do that in the next sections and after that, we'll finally finish off the lobby system.

Next Part.
Previous Part.

Back to top