yasio

YASIO - Y et A nother S ocket I / O library.

English

yasio是一個輕量級跨平台的非同步網路庫，專注於客戶端和基於各種遊戲引擎的遊戲用戶端網路服務，支援windows、macos、ios、android、ohos、linux、freebsd 以及其他類unix 作業系統。

支援平台

Build	Status (github)
Windows(msvc,clang,mingw)
Windows(vs2013)
Android
iOS/tvOS/watchOS
Linux
macOS
FreeBSD
Solaris

應用案例

• 放置少女（HD）：用於cocos和unity重製版客戶端網路傳輸。
• 紅警OL手遊專案：用於客戶端網路傳輸，並且隨著專案於2018年10月17日由騰訊遊戲發行正式上線後穩定運行於上千萬行動裝置上。
• x-studio軟體專案：網路解決方案。
• QttAudio：語音連麥聊天整合方案。

整合案例

• Unity
  • yasio_unity：Unity 純C#封裝，打開場景SampleScene運行即可。
  • xlua：將yasio整合到xlua, 開啟場景U3DScripting運行即可。
• UnrealEngine
  • yasio_unreal：yasio的UnrealEngine外掛。
  • sluaunreal：整合到Tencent的sluaunreal。
  • UnLua：整合到Tencent的UnLua。
• axmol：作為axmol遊戲引擎的網路解決方案。

文件

• https://yasio.github.io/yasio

使用g++快速運行tcptest測試程序

g++ tests/tcp/main.cpp --std=c++11 -DYASIO_HEADER_ONLY -lpthread -I./ -o tcptest && ./tcptest

使用CMake編譯yasio的測試程序和範例程序

git clone --recursive https://github.com/yasio/yasio
cd yasio

# 如果是 macOS Xcode, 这里命令应该换成：cmake -B build -GXcode
cmake -B build

# 使用CMake命令行编译, 如果需要调试，则使用相应平台IDE打开即可:
# a. Windows：使用VisualStudio打开build/yasio.sln
# b. macOS：使用Xcode打开build/yasio.xcodeproj
cmake --build build --config Debug

# # 者直接用VS打开 

特性：

• 支援TCP，UDP，KCP傳輸，且API是統一的。
• 支援TCP黏包處理，業務完全不必關心。
• 支援組播。
• 支援IPv4/IPv6或蘋果IPv6_only網路。
• 支援處理多個連線的所有網路事件。
• 支援微秒定時器。
• 支援Lua綁定。
• 支援Cocos2d-x jsb綁定。
• 支援CocosCreator jsb2.0綁定。
• 支援Unity3D。
• 支援虛幻引擎。
• 支援SSL客戶端/服務端, 基於OpenSSL/MbedTLS。
• 支援非阻塞域名解析，基於c-ares。
• 支援Header Only整合方式，只需要定義編譯預處理器巨集YASIO_HEAD_ONLY=1即可。
• 支援Unix Domain Socket。
• 支援二進位讀寫，兩個工具類obstream/ibstream非常方便使用。
• 支援和.net相容的整數壓縮編碼方式： 7Bit Encoded Int/Int64 。

關於C++14/17/20

yasio提供如下可在C++11編譯器下使用的C++14/17/20標準函式庫元件，請查看yasio/string_view.hpp, yasio/shared_mutex.hpp, yasio/memory.hpp

• cxx14::make_unique
• cxx17::string_view
• cxx17::shared_mutex
• cxx20::starts_with
• cxx20::ends_with
• yasio::byte_buffer
• yasio::pod_vector

關於OpenSSL 預編譯函式庫(Windows)

yasio 的cmake 腳本預設選擇OpenSSL 作為SSL 支援庫，並且會自動從1kiss下載， 且預先編譯庫使用VS2022(MSVC-14.39)編譯，如果你的系統未安裝該版本，請傳入CMake 參數-DYASIO_SSL_BACKEND=2 ，例如使用專案提供的跨平台一鍵編譯腳本build.ps1

 powershell build.ps1 -p win32 -a x64 -xc " -DYASIO_SSL_BACKEND=2 " 

框架圖

QQ交流群

點擊加入：829884294