Skip to content

Installation Guide

Dependency Alert

Before installing Best SocketIO, ensure you have the Best HTTP package and the Best WebSockets package installed and set up in your Unity project. If you haven't done so yet, refer to the Best HTTP Installation Guide and the Best WebSockets Installation Guide.

Getting started with Best SocketIO demands a prior setup of both the Best HTTP and Best WebSockets packages. After ensuring these are properly integrated, you can then effortlessly add Best SocketIO to your Unity projects.

Installing from the Unity Asset Store using the Package Manager Window

  1. Purchase: If you haven't previously purchased the package, proceed to do so. Once purchased, Unity will recognize your purchase, and you can install the package directly from within the Unity Editor. If you already own the package, you can skip these steps.
    1. Visit the Unity Asset Store: Navigate to the Unity Asset Store using your web browser.
    2. Search for Best SocketIO: Locate and choose the official Best SocketIO package.
    3. Buy Best SocketIO: By clicking on the Buy Now button go though the purchase process.
  2. Open Unity & Access the Package Manager: Start Unity and select your project. Head to Window > Package Manager.
  3. Select 'My Assets': In the Package Manager, switch to the My Assets tab to view all accessible assets.
  4. Find Best SocketIO and Download: Scroll to find "Best SocketIO". Click to view its details. If it isn't downloaded, you'll notice a Download button. Click and wait. After downloading, this button will change to Import.
  5. Import the Package: Once downloaded, click the Import button. Unity will display all Best SocketIO' assets. Ensure all are selected and click Import.
  6. Confirmation: After the import, Best SocketIO will integrate into your project, signaling a successful installation.

Installing from a .unitypackage file

If you have a .unitypackage file for Best SocketIO, follow these steps:

  1. Download the .unitypackage: Make sure the Best SocketIO.unitypackage file is saved on your device.
  2. Import into Unity: Open Unity and your project. Go to Assets > Import Package > Custom Package.
  3. Locate and Select the .unitypackage: Find where you saved the Best SocketIO.unitypackage file, select it, and click Open.
  4. Review and Import: Unity will show a list of all the package's assets. Ensure all assets are selected and click Import.
  5. Confirmation: Post import, you'll see all the Best SocketIO assets in your project's Asset folder, indicating a successful setup.

Note

Best SocketIO also supports other installation techniques as documented in Unity's manual for packages. For more advanced installation methods, please see the Unity Manual on Sharing Packages.

Assembly Definitions and Runtime References

For developers familiar with Unity's development patterns, it's essential to understand how Best SocketIO incorporates Unity's systems:

  • Assembly Definition Files: Best SocketIO incorporates Unity's Assembly Definition files. It aids in organizing and managing the codebase efficiently.
  • Auto-Referencing of Runtime DLLs: The runtime DLLs produced by Best SocketIO are Auto Referenced, allowing Unity to automatically recognize and utilize them without manual intervention.
  • Manual Package Referencing: Should you need to reference Best SocketIO manually in your project (for advanced setups or specific use cases), you can do so. Simply reference the package by searching for com.Tivadar.Best.SocketIO.

Congratulations! You've successfully integrated Best SocketIO into your Unity project. Begin your SocketIO adventure with the Getting Started guide.

For any issues or additional assistance, please consult the Community and Support page.

Comments