Nakama for Mac 搭建開發(fā)環(huán)境
1.基礎工具
1.1 go環(huán)境部署
1.2 數(shù)據(jù)庫部署
這里本人使用的是PostgreSQL
1.3 nakama源碼下載
2.編譯源碼?
2.1 安裝工具鏈
go install \
"google.golang.org/protobuf/cmd/protoc-gen-go" \
"google.golang.org/grpc/cmd/protoc-gen-go-grpc" \
"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway" \
"github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2"
2.2 如果您對嵌入式控制臺進行了更改
cd console/ui
ng serve
2.3 重新生成協(xié)議緩沖區(qū)、網(wǎng)關代碼和控制臺 UI
env PATH="$HOME/go/bin:$PATH" go generate -x ./...
2.4 構建代碼
go build -trimpath -mod=vendor
2.5 得到編譯后文件 nakama
2.6 自定義服務器代碼編譯
2.6.1 初始化自定義項目
mkdir go-project
cd go-project
2.6.2 提供有效的Go模塊路徑太颤,并安裝nakama運行時
go mod init example.com/go-project
go get github.com/heroiclabs/nakama-common/runtime
2.7 提供包依賴
go mod vendor
2.8 創(chuàng)建GO共享對象(生成so)
go build --trimpath --mod=vendor --buildmode=plugin -o ./backend.so
3.配制游戲服務
完成2操作之后挽拔,我們手上擁有一個nakama Unix可執(zhí)行文件以及backend.so 文件
接下來我們將編寫nakama配制文件nakama-config.yml
#配制文件相關
name: nakama-node-1 # 節(jié)點名稱(必須是唯一的)
data_dir: "./data/" # Nakama 將存儲其數(shù)據(jù)(包括日志)的可寫文件夾的絕對路徑。默認值是啟動 Nakama 的工作目錄啸蜜。
logger:
stdout: false # 將日志重定向到控制臺標準輸出杯聚。將不再使用日志文件哥纫。默認為true。
level: "warn" # 要生成的最低日志級別召川。值是debug南缓,info,warn和error荧呐。默認為info汉形。
file: "./data/path/to/logfile.log" # 將輸出記錄到文件(以及stdout是否已設置)。確保目錄和文件是可寫的倍阐。
metrics: # 指標概疆?
reporting_freq_sec: 60 # 指標導出的頻率。默認值為 60 秒峰搪。
namespace: "" # Prometheus 的命名空間或 Stackdriver 指標的前綴岔冀。它總是在節(jié)點名稱前面。默認值為空概耻。
prometheus_port: 0 # 暴露 Prometheus 的端口使套。默認值為“0”,禁用 Prometheus 導出鞠柄。
database:
address:
- "ysr:123456@localhost:5432" # 要連接的數(shù)據(jù)庫節(jié)點列表侦高。它應該遵循username:password@address:port/dbname(postgres://協(xié)議自動附加到路徑)的形式。默認為root@localhost:26257.
conn_max_lifetime_ms: 0 # 在連接被終止并創(chuàng)建新連接之前重用數(shù)據(jù)庫連接的時間(以毫秒為單位)厌杜。默認值為 0(不確定)奉呛。
max_open_conns: 0 # 允許打開的數(shù)據(jù)庫連接的最大數(shù)量。默認值為 0(無限制)夯尽。
max_idle_conns: 100 # 允許打開但未使用的數(shù)據(jù)庫連接的最大數(shù)量瞧壮。默認值為 100。
runtime:
env: # 作為環(huán)境變量公開給運行時腳本的鍵值屬性列表匙握。
- "example_apikey=example_apivalue"
- "encryptionkey=afefa==e332*u13=971mldq"
path: "./data/modules/folders" # 服務器在啟動時掃描和加載的模塊路徑咆槽。默認值為data_dir/modules。
http_key: "testhttpkey" # 用于驗證 HTTP 運行時調(diào)用的密鑰肺孤。默認值為defaultkey罗晕。
socket:
server_key: "testsocketkey" # 用于建立與服務器的連接的服務器密鑰济欢。默認值為defaultkey
port: 7350
max_message_size_bytes: 4096 # 每條消息允許從客戶端套接字讀取的最大數(shù)據(jù)量(以字節(jié)為單位)赠堵。用于實時連接小渊。默認值為 4096。
read_timeout_ms: 10000 # 讀取整個請求的最大持續(xù)時間(以毫秒為單位)茫叭。用于 HTTP 連接酬屉。默認值為 10000。
write_timeout_ms: 10000 # 超時寫入響應之前的最大持續(xù)時間(以毫秒為單位)揍愁。用于 HTTP 連接呐萨。默認值為 10000。
idle_timeout_ms: 60000 # 啟用保持活動時等待下一個請求的最長時間(以毫秒為單位)莽囤。用于 HTTP 連接谬擦。默認值為 60000。
write_wait_ms: 5000 # 寫入數(shù)據(jù)時等待來自客戶端的確認的時間(以毫秒為單位)朽缎。用于實時連接惨远。默認值為 5000。
pong_wait_ms: 10000 # 發(fā)送 ping 后等待來自客戶端的 pong 消息的時間(以毫秒為單位)话肖。用于實時連接北秽。默認值為 25000。
ping_period_ms: 8000 # Must be less than pong_wait_ms 客戶端 ping 消息之間的等待時間(以毫秒為單位)最筒。該值必須小于pong_wait_ms贺氓。用于實時連接。默認值為 15000床蜘。
outgoing_queue_size: 16 # 等待發(fā)送到客戶端的最大消息數(shù)辙培。如果超過這個值,客戶端會被認為太慢并且會斷開連接邢锯。在處理實時連接時使用虏冻。默認值為 16。
social: # 社交網(wǎng)絡獲取用戶信息
steam: # steam
publisher_key: ""
app_id: 0
console: # 嵌入式開發(fā)者控制臺相關的配置
port: 7351
username: "admin"
password: "password"
cluster: # 節(jié)點應如何相互連接以形成集群
join:
- "10.0.0.2:7352"
- "10.0.0.3:7352"
gossip_bindaddr: "0.0.0.0"
gossip_bindport: 7352
rpc_port: 7353
local_priority: true
work_factor_interval_ms: 1000
matchmaker: # 賽事匹配/房間匹配
max_tickets: 2 # 每個會話或聚會允許的最大并發(fā)匹配票數(shù)弹囚。默認 3
interval_sec: 15 # 媒人嘗試形成比賽的速度厨相,以秒為單位。默認 15
max_intervals: 3 # 在允許最小計數(shù)之前鸥鹉,匹配器嘗試在最大玩家計數(shù)處查找匹配的時間間隔蛮穿。默認 2。
iap: # 應用內(nèi)購買
apple:
shared_password: "password"
google:
client_email: "email@google.com"
private_key: "pk"
huawei:
public_key: "pk"
client_id: "id"
client_secret: "secret"
完成配制文件之后 則進行nakama數(shù)據(jù)庫遷移以及服務器數(shù)據(jù)庫配制
# 遷移數(shù)據(jù)庫 官方推薦默認執(zhí)行
./nakama migrate up --database.address ysr:123456@localhost:5432
# 通過配制文件啟動nakama服務
./nakama --config /nakama-config.yml --database.address ysr:123456@localhost:5432/nakama
最后通過localhost:7351進入控制臺 查看go modules是否正常導入
image-20220123141407714.png