版本

作者

参与者

完成日期

备注

UnityAPI_Network_V01_1.0

严立钻

2020.06.16

立钻哥哥：Unity是一个入门快、提高难的游戏引擎，想要提升能力，至少需要越过3道坎：API+Shader+综合能力；

++1、API的积累：对API的合理利用不仅可以减轻自己的编码负担，而且往往可以提高程序的运行效率；这也是钻哥开始“Unity API”独立打造分类的初衷；

++2、Shader编程：想要做出一款精品游戏往往需要有高效的Shader的支持；Unity提供了一套改良的“Shader Lab”系统，优化了繁杂的“Open GL”编程；

++3、综合能力（技术+业务+管理）：一款产品的制作除了功能编程外，往往会涉及很多其他领域，例如产品架构、UI交互设计、模型制作等，作为主要的编程人员，对其他相关领域的了解程序往往会影响到产品制作直至最后的产品体验；

++++立钻哥哥一直在推动【VR云游戏=Unity+SteamVR+云技术+5G+AI】，这个只是一个引子，抛砖引玉让大家对整个知识体系有一个明确的落地方向，宝宝们可以根据自己的兴趣方向进行拓展：比如Unity这里是指一种“3D游戏引擎”，也可拓展至“UE4、Cocos2dx”等游戏引擎；SteamVR是一种跨硬件解决方案，也可拓展至“VRTK”等第三方插件；“云技术+5G”是一种跨平台解决方案的核心技术，同样可拓展至其他平台解决方案；AI也是一种先进技术的举例，也可以拓展至任何一种前沿技术；

#Network网络

#Network网络

++A1、Description描述

++B2、Variables变量

++C3、Public Function共有函数

++D4、Message消息

#A1、Description描述

#B2、Static Variables静态变量

++B2、Static Variables静态变量

++++B2.1、connections

++++B2.2、connectionTesterIP

++++B2.3、connectionTesterPort

++++B2.4、incomingPassword

++++B2.5、isClient

++++B2.6、isMessageQueueRunning

++++B2.7、isServer

++++B2.8、logLevel

++++B2.9、maxConnections

++++B2.10、minimumAllocatableViewIDs

++++B2.11、natFacilitatorIP

++++B2.12、natFacilitatorPort

++++B2.13、peerType

++++B2.14、player

++++B2.15、proxyIP

++++B2.16、proxyPassword

++++B2.17、proxyPort

++++B2.18、sendRate

++++B2.19、time

++++B2.20、useProxy

++++B2.21、YanlzXREngine.Network.StaticVariables

++B2.1、connections

public static NetworkPlayer[] connections;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnGUI(){

        if(GUILayout.Button(“立钻哥哥：Disconnect first player.”)){

            if(Network.connections.Length > 0){

                Debug.Log(“立钻哥哥：Disconnecting: ” + Network.connections[0].ipAddress + “:” + Network.connections[0].port);

                Network.CloseConnection(Network.connections[0], true);

            }    //立钻哥哥：if(Network.connections.Length > 0){}

        }    //立钻哥哥：if(GUILayout.Button()){}

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.2、connectionTesterIP

public static string connectionTesterIP;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void MyResetIP(){

        Network.connectionTesterIP = “127.0.0.1”;

        Network.connectionTesterPort = 10000;

    }    //立钻哥哥：void ResetIP(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.3、connectionTesterPort

public static int connectionTesterPort;

++B2.4、incomingPassword

public static string incomingPassword;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void MyConnectToServer(){

        Network.Connect(“127.0.0.1”, 25000, “YanlzGameServ”);

    }    //立钻哥哥：void ConnectToServer(){}

    void MyLaunchServer(){

        Network.incomingPassword = “Helloi360Game”;

        Network.InitializeServer(32, 25000);

    }    //立钻哥哥：void MyLaunchServer(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.5、isClient

public static bool isClient;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnGUI(){

        if(Network.isServer){

            GUILayout.Label(“立钻哥哥：Running as a server.”);

        }else{

            if(Network.isClient){

                GUILayout.Label(“立钻哥哥：Running as a client.”);

            }    //立钻哥哥：if(Network.isClient){}

        }    //立钻哥哥：if(Network.isServer){}

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.6、isMessageQueueRunning

public static bool isMessageQueueRunning;

++B2.7、isServer

public static bool isServer;

++B2.8、logLevel

public static NetworkLogLevel logLevel;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void Start(){

        Network.logLevel = NetworkLogLevel.Full;

    }    //立钻哥哥：void Start(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.9、maxConnections

public static int maxConnections;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void StartMyGameNow(){

        Network.maxConnections = -1;

    }    //立钻哥哥：void StartMyGameNow(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.10、minimumAllocatableViewIDs

public static int minimumAllocatableViewIDs;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void Awake(){

        Network.minimumAllocatableViewIDs = 500;

    }    //立钻哥哥：void Awake(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.11、natFacilitatorIP

public static string natFacilitatorIP;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void MyResetIP(){

        Network.natFacilitatorIP = “127.0.0.1”;

        Network.natFacilitatorPort = 10001;

    }    //立钻哥哥：void MyResetIP(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.12、natFacilitatorPort

public static int natFacilitatorPort;

++B2.13、peerType

public static NetworkPeerType peerType;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnGUI(){

        if(Network.peerType == NetworkPeerType.Disconnected){

            GUILayout.Label(“立钻哥哥：No Connected.”);

        }else{

            if(Network.peerType == NetworkPeerType.Connecting){

                GUILayout.Label(“立钻哥哥：Not Connected.”);

            }else{

                GUILayout.Label(“立钻哥哥：Network started.”);

            } //立钻哥哥：if(Network.peerType==NetworkPeerType.Connecting){}else{}

        }    //立钻哥哥：if(Network.peerType == NetworkPeerType.Disconnected){}else{}

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.14、player

public static NetworkPlayer player;

++B2.15、proxyIP

public static string proxyIP;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void Awake(){

        Network.proxyIP = “1.1.1.1”;

        Network.proxyPort = 1111;

    }    //立钻哥哥：void Awake(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.16、proxyPassword

public static string proxyPassword;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void Awake(){

        Network.proxyIP = “1.1.1.1”;

        Network.proxyPort = 1111;

        Network.proxyPassword = “YanlzTest”;

    }    //立钻哥哥：void Awake(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.17、proxyPort

public static int proxyPort;

++B2.18、sendRate

public static float sendRate;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void Awake(){

        Network.sendRate = 25;

    }    //立钻哥哥：void Awake(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.19、time

public static double time;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    public float something;

    public double transitTime;

    void OnSerializeNetworkView(BitStream stream, NetworkMessageInfo info){

        float horizontalInput = 0.0F;

        if(stream.isWriting){

            horizontalInput = transform.position.x;

            stream.Serialize(ref horizontalInput);

        }else{

            transitTime = Network.time - info.timestamp;

            stream.Serialize(ref horizontalInput);

            something = horizontalInput;

        }    //立钻哥哥：if(stream.isWriting){}else{}

    }    //立钻哥哥：void OnSerializeNetworkView(){}

    void OnGUI(){

        GUILayout.Label(“立钻哥哥：Last transmission time: ” + transitTime);

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++B2.20、useProxy

public static bool useProxy;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    public bool imaserver;

    public string serverIP;

    public int serverPort;

    public bool serverUsesNAT;

    void Awake(){

        Network.proxyIP = “1.1.1.1”;

        Network.proxyPort = 1111;

        if(imaserver){

            StartMyServerWithProxy();

        }else{

            ConnectToMyServerWithProxy();

        }    //立钻哥哥：if(imaserver){}else{}

    }    //立钻哥哥：void Awake(){}

    void StartMyServerWithProxy(){

        Network.useProxy = true;

        Network.InitializeServer(2, 25000, false);

    }    //立钻哥哥：void StartMyServerWithProxy(){}

    void OnMyServerInitialized(NetworkPlayer player){

        if(Network.useProxy && imaserver){

            Debug.LogError(“立钻哥哥：Failed to connect to proxy server: ” + msg);

        }    //立钻哥哥：if(Network.useProxy){}

    }    //立钻哥哥：void OnServerInitialized(){}

    void ConnectToMyServerWithProxy(){

        Network.useProxy = true;

        Network.Connect(serverIP, serverPort);

    }    //立钻哥哥：void ConnectToMyServerWithProxy(){}

    void OnConnectedToMyServer(){

        Debug.Log(“立钻哥哥：Connected successfully to server.”);

    }    //立钻哥哥：void OnConnectedToMyServer(){}

}    //立钻哥哥：public class YanlzNetwork{}

#C3、Static Functions静态函数

++C3、Static Functions静态函数

++++C3.1、AllocateViewID

++++C3.2、CloseConnection

++++C3.3、Connect

++++C3.4、Destroy

++++C3.5、DestroyPlayerObjects

++++C3.6、Disconnect

++++C3.7、GetAveragePing

++++C3.8、GetLastPing

++++C3.9、HavePublicAddress

++++C3.10、InitializeSecurity

++++C3.11、InitializeServer

++++C3.12、Instantiate

++++C3.13、RemoveRPCs

++++C3.14、RemoveRPCsInGroup

++++C3.15、SetLevelPrefix

++++C3.16、SetReceivingEnabled

++++C3.17、SetSendingEnabled

++++C3.18、TestConnection

++++C3.19、TestConnectionNAT

++++C3.20、YanlzXREngine.Network.StaticFunctions

++C3.1、AllocateViewID

public static NetworkViewID AllocateViewID();

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    public Transform cubePrefab;

    public NetworkView nView;

    void Start(){

        nView = GetComponent<NetworkView>();

    }    //立钻哥哥：void Start(){}

    void OnGUI(){

        if(GUILayout.Button(“YanlzSpawnBox”)){

            NetworkViewID viewID = Network.AllocateViewID();

            nView.RPC(“YanlzSpawnBox”, RPCMode.AllBuffered, viewID, transform.position);

        }    //立钻哥哥：if(GUILayout.Button()){}

    }    //立钻哥哥：void OnGUI(){}

    [RPC]

    void YanlzSpawnBox(NetworkViewID viewID, Vector3 location){

        Transform clone;

        clone = Instantiate(cubePrefab, location, Quaternion.identity) as Transform;

        NetworkView nView;

        nView = clone.GetComponent<NetworkView>();

        nView.viewID = viewID;

    }    //立钻哥哥：void SpawnBox(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.2、CloseConnection

public static void CloseConnection(NetworkPlayer target, bool sendDisconnectionNotification);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnGUI(){

        if(GUILayout.Button(“立钻哥哥：Disconnect form server.”)){

            Debug.Log(“立钻哥哥：Disconnecting: ” + Network.connections[0].ipAddress + “:” + Network.connections[0].port);

            Network.CloseConnection(Network.connections[0], true);

        }else{

            if(Network.connections.Length == 0){

                Debug.Log(“立钻哥哥：No one is connected.”);

            }else{

                if(Network.connections.Length > 1){

                    Debug.Log(“立钻哥哥：Too many connections. Are we running a server?”);

                }    //立钻哥哥：if(Network.connections.Length > 1){}

            }    //立钻哥哥：if(Network.connections.Length == 0){}else{}

        }    //立钻哥哥：if(GUILayout.Button(“Disconnect form server”)){}else{}

        if(GUILayout.Button(“立钻哥哥：Disconnect first player.”)){

            if(Network.connections.Length > 0){

                Debug.Log(“立钻哥哥：Disconnecting: ” + Network.connections[0].ipAddress + “:” + Network.connections[0].port);

                Network.CloseConnection(Network.connections[0], true);

            }    //立钻哥哥：if(Network.connections.Length>0){}

        }    //立钻哥哥：if(GUILayout.Button(“立钻哥哥：Disconnect first player.”)){}

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.3、Connect

public static NetworkConnectionError Connect(string IP, int remotePort, string password=””);

public static NetworkConnectionError Connect(string[] IPs, int remotePort, string password=””);

public static NetworkConnectionError Connect(string GUID, string password=””);

public static NetworkConnectionError Connect(HostData hostData, string password=””);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void ConnectToMyServer(){

        Network.Connect(“127.0.0.1”, 25000);

    }    //立钻哥哥：void ConnectToMyServer(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.4、Destroy

public static void Destroy(NetworkViewID viewID);

public static void Destroy(GameObject gameObject);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    public float timer = 0;

    void Awake(){

        timer = Time.time;

    }    //立钻哥哥：void Awake(){}

    void Update(){

        if(Time.time - timer > 2){

            Network.Destroy(GetComponent<NetworkView>().viewID);

            //Network.Destroy(gameObject);

        }    //立钻哥哥：if(Time.time-timer>2){}

    }    //立钻哥哥：void Update(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.5、DestroyPlayerObjects

public static void DestroyPlayerObjects(NetworkPlayer playerID);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnPlayerDisconnected(NetworkPlayer player){

        Debug.Log(“立钻哥哥：Clean up after player ” + player);

        Network.RemoveRPCs(player);

        Network.DestroyPlayerObjects(player);

    }    //立钻哥哥：void OnPlayerDisconnected(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.6、Disconnect

public static void Disconnect(int timeout = 200);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnGUI(){

        if(GUILayout.Button(“立钻哥哥：Disconnect.”)){

            Network.Disconnect();

            MasterServer.UnregisterHost();

        }    //立钻哥哥：if(GUILayout.Button()){}

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.7、GetAveragePing

public static int GetAveragePing(NetworkPlayer player);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzNetwork : MonoBehaviour{

    void OnGUI(){

        GUILayout.Label(“立钻哥哥：Player ping values.”);

        int i = 0;

        while(i < Network.connections.Length){

            GUILayout.Label(“立钻哥哥：Player ” + Network.connections[i] + “ - ” + Network.GetAveragePing(Network.connections[i]) + “ ms”);

            i++;

        }    //立钻哥哥：while(){}

    }    //立钻哥哥：void OnGUI(){}

}    //立钻哥哥：public class YanlzNetwork{}

++C3.8、GetLastPing

#E5、立钻哥哥对Network类的拓展

立钻哥哥推荐的拓展学习链接（Link_Url）