apparatno/snakeserver

Snakes on a plate 镜像说明

镜像概述

本镜像为蛇游戏的后端服务，是连接网页控制器与ESP8266硬件屏幕的核心组件，支持由Neopixel灯带构成的物理屏幕与网页端的互动蛇游戏运行。

核心功能

• 游戏状态查询：通过GET /state接口获取当前是否有活跃游戏（返回playing表示游戏进行中）。
• 屏幕数据获取：通过GET /screen接口获取棋盘像素状态（0=关闭、1=蛇身、2=果实），游戏结束时返回404。
• 游戏启动：通过POST /play接口启动新游戏，返回玩家令牌（playerToken），已存在活跃游戏时返回400。
• 游戏操作：通过POST /action接口发送方向指令（U/D/L/R）或重启指令（X），需携带playerToken。

使用场景

适用于DIY互动蛇游戏项目，结合蛇游戏客户端（https://github.com/apparatno/snake-client%EF%BC%89%E5%92%8C%E7%A1%AC%E4%BB%B6%E6%8E%A7%E5%88%B6%E7%A8%8B%E5%BA%8F%EF%BC%88https://github.com/apparatno/snake-microprocessor%EF%BC%89%EF%BC%8C%E5%AE%9E%E7%8E%B0%E7%89%A9%E7%90%86%E5%B1%8F%E5%B9%95%E4%B8%8E%E7%BD%91%E9%A1%B5%E6%8E%A7%E5%88%B6%E7%9A%84%E6%B8%B8%E6%88%8F%E4%BD%93%E9%AA%8C%E3%80%82

配置说明

• 端口映射：需将容器端口映射到主机（假设默认端口为8080），以便网页端和硬件访问。
• 依赖组件：需搭配对应的客户端和硬件程序使用，确保接口交互正常。

Docker部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 apparatno/snakeserver

Docker Compose示例

yaml
version: '3'
services:
  snakeserver:
    image: apparatno/snakeserver
    ports:
      - "8080:8080"
    restart: unless-stopped