daguye918/wawaji

雪暴网络娃娃机安卓版配套测试工程源码及配置工具 点击这里查看本项目的WIKI文档

网络娃娃机

线上线下弹珠机

雪暴网络科技是一家提供网络娃娃机实体机器并提供使用该机器开发网络娃娃机app相关技术支持的公司。我们以卖机器为主，附带提供如何开发，部署的一些简单技术支持。方便您购买机器后，能够知道如何开发并运行自己的网络娃娃机项目。

使用雪暴娃娃机的安卓版套装，您可以方便的开发支持双路摄像头推流的安卓软件,配合娃娃机实现视频和操作的反馈。
或:
1.通过我们提供的xuebaoRtmpPush快速拥有一个完整的支持双路视频RTMP推流并使娃娃机联网的解决方案。配合** 大牛直播SDK播放端**，将可以使视频延迟保证在一秒以内。

支持通用的rtmp播放器来进行播放视频。您也可以选择腾讯的sdk或者ijkplayer等播放组件来播放视频。经过适当的调整，相信延迟问题都能得到很好的解决。我们有客户使用腾讯的播放延迟非常令人惊叹，但我们不清楚他具体是怎么做到的。我们自己并未测出来如此效果。
只需要配置相应的视频服务器地址，应用服务器地址，流媒体服务器地址，娃娃机就可以正确联网并推流视频。
通过我们提供的简单客户端（SimpleClient）和服务器(SimpleServer)，您可以快速的了解如何操作雪暴网络娃娃机以及如何开发您的应用服务器。定制您自己的网络娃娃机项目。
配套xuebaoRtmpPush公网，局域网，本机，升级，安装，管理的一系列工具软件,该管理软件所使用的协议已经在wiki放出，且该工具的源码都已开放，以便您开发自己的管理软件。
此双路推流程序xuebaoRtmpPush由大牛直播授权使用于雪暴公司出品的安卓板。任何人不得将其使用除本程序和本安卓板以外的任何其他地方。否则一经发现，雪暴公司和大牛直播将有权起诉其侵权。

2.本安卓板硬件和固件都已支持双路摄像头推流，因此它也支持各种互动直播技术，如腾讯互动直播，阿里连麦，即构，anyRCT的私有视频传输协议。
基于本安卓版的 anyRTC 应用案例http://wawaji.anyrtc.cc/

基于本安卓版的即构 webH5 应用案例 http://wwj.zego.im/ 以上方案已完整的对接好我们的整套硬件，提供直接可用的整套产品。包含推流端、服务器端、播放端、操作客户端
您也可以选择自行开发您的推流程序和私有协议，此时您也可以购买我们的产品，此时:
在您的apk中，您将需要

自己采集摄像头的数据，并区分绑定前后摄像头，然后将数据编码并发送给您的(流媒体，或其他协议)服务器。
根据网络娃娃机主板发来的命令处理数据并转发给应用服务器。该文档对应[网络娃娃机主板对接协议.docx].更详细的在wiki提供。

您还将需要

自己开发配套的协议来标识并管理您的娃娃机。

本项目是雪暴网络娃娃机安卓版使用说明及例子源码。包含RTMP推流端程序及配套的配置工具软件，简单应用服务器示例源码，简单操作客户端示例源码，娃娃机协议文档。

以下是雪暴网络娃娃机安卓版部署流程: 点击这里查看最全面的指南

1.首先购买雪暴网络娃娃机安卓版套装。然后根据要求安装好摄像头并摆好位置。连接网线，开机上电。

2.使用prebuild中的[安卓版电脑有线部署工具]文件夹中的安装脚本或[雪暴安卓板局域网批量部署工具.zip]将xuebaoRtmpPush.apk安装到安卓板上,或者您自己从源码编译安装，这时，如果网线已连接到路由器，则该娃娃机已正常工作。
--此APK提供标准RTMP双路视频推流，及处理娃娃机命令等操作。如选择自己的私有协议，则此步骤必须跳过。

3.运行SimpleServer程序-即开启应用服务器，记录好服务器此时的IP。--如果您已熟知娃娃机的协议，可以忽略本例子代码自行开发您的应用服务器。

Built SimpleServer.c:
OS require:linuxmint or ubuntu

type in terminal.
g++ -std=c++11 -pthread ./SimpleServer.c -o SimpleServer

run
./SimpleServer

exit
input exit then press Enter to stop the server normally.

SimpleServer java版

windows下直接用eclipse 打开工程SimpleServer 点运行即可。
linux请先安装配置好环境变量如ubuntu 或linuxmint。先执行sudo vim /etc/profile 最后一行加上如下字段。--请以您自己下载的路径为准。本例只是给个说明

JAVA_HOME=/opt/jdk1.8.0_162
CLASSPATH=.;$JAVA_HOME/lib/dt.jar;$JAVA_HOME/lib/tools.jar;
PATH=$PATH:$JAVA_HOME/bin
export PATH JAVA_HOME CLASSPATH

然后
切换到SimpleServer/src 输入：javac SimpleApp.java
再输入:java SimpleApp

如何优雅的停止服务器? 只需要在Eclipse的控制台窗口或linux的app所在terminal 输入exit即可。这样才不会因端口资源没法释放，导致短时间不能再启动的情况

4.配置娃娃机参数。可使用本工程自带的局域网，公网配置软件，或安卓版连接鼠标显示器自行配置应用服务器地址、推流视频质量，及推流地址，娃娃机名称等属性。 (使用SimpleServer做服务器时，应用服务器端口设置为7770, 配置服务器端口设置为7776)

5.此时，如果在应用服务器看到娃娃机有心跳连接。则表示娃娃机已准备就绪。

正常工作如图

6.将prebuild文件夹下的simpleClient.apk(安卓4.4以上)安装到您的手机上。或者，您可以从simpleClient工程中自行编译出一个apk出来。请将该手机通过wifi连入娃娃机所在的一个局域网。
然后点开配置按钮(右上角齿轮状图标)，输入应用服务器IP，端口默认为7771 。如您已架设流媒体服务器，请输入之前娃娃机配好的推流地址。点击OK，您就可以开始玩网络抓娃娃了。
下图是simpleClinet.apk的简单界面示意图。

友情提示:建议使用者先运行一个局域网版本的快速测试。因为公网的服务器是需要申请，审核的。部署公网将需要您的技术人员自行购买公网服务安装部署应用服务器及流媒体服务器。
当快速搭建局域网流程时，务必确保手机客户端、服务器、娃娃机都在一个网段，以便于他们能够互相访问。
局域网仅为了快速看效果需要。部署到公网时只是各个客户端的连接ip地址改成该服务器所在的IP地址或域名即可。

常见问题：娃娃机是动了，为什么看不到视频？
因为您的娃娃机需要配置推流地址。您需要您的技术人员部署一个流媒体服务器，并设置推流参数为您的流媒体服务器所需要的格式。simpleClinet也需要设置相应的视频推流地址。

工程文件说明

[xuebaoRtmpPush] 基于大牛SDK双路RTMP摄像头推流及娃娃机指令交互安卓板源码。 此摄像头推流程序已获得大牛直播授权使用于本安卓板
- xuebaoRtmpPush启动后，会自动注册到配置服务器，外网配置工具可通过配置服务器配置安卓板参数-可选项。当您暂时不用外网来进行配置修改时，这个功能可以无视。请把配置服务器地址和端口都留空。
- 目前没做用户认证，因此多个用户同时修改一个娃娃机的配置时，只有最后一个配置者的命令会生效。
- 要编译此源码，请使用AndroidStudio 2.3版本，Android SDK 26.然后使用根目录下的签名文件xuebao_android_key.jks 密码都是123456。Key alias:xuebao 来执行编译并生成release apk即可。
[SimpleClient] 简单操作客户端-安卓版的源码。
- 您可以通过此源码更好的熟悉娃娃机的操作命令。
- 或直接在此基础上开发出您特有的网络娃娃机app。
- 本客户端视频播放使用了** 大牛直播SDK** 如要商用请自己联系，我们不负责版权问题
- 您也可以根据自己的需求选择腾讯SDK或者ijkplayer来实现视频流播放。
[SimpleServer]简单应用服务器java源码。
- 兼容串口版和安卓版的娃娃机协议。
- 包含了应用服务器基本的工作流程。比如列举房间列表，玩家进出，开始玩的命令中转到网络娃娃机的基本流程。
- 支持多个玩家，多个娃娃机。但同一时间，一台娃娃机只能由一个玩家操控。
- 您可以自行二次开发实现排队预约，支付等等功能。
- 应用服务器（默认端口:娃娃机请连接到7770 端口。玩家手机客户端simpleClient.apk请连接到7771）
- 配置服务器[可选] （默认端口对于安卓板xuebaoRtmpPush是7776，对于公网配置工具是7778）--如果不用配置功能。这个相关代码都可以忽略。
[juyuwangbushu] 局域网部署工具的源码。该工程编译出来的工具用于批量安装xuebaoRtmpPush.apk.因为我们出厂是不带这个apk的。需要你们自行安装。该工具在prebuild里面有直接编译好的版本。
[juyuwangpeizhi] 局域网批量配置工具的源码。该工程编译出来的工具可以给xuebaoRtmpPush配置推流地址，推流质量，应用服务器地址等。该工具在prebuild里面有直接编译好的版本。
[prebuild] 包含了最新的安卓推流程序, 局域网配置工具公网配置工具预生成的安卓简单操作客户端.
- 安卓版电脑有线部署工具，电脑有线直连安装脚本。
- simpleClient.apk 手机玩家简单客户端.也可以自行从SimpleClient编译生成。
- xuebaoRtmpPush.apk 由源码编译出来的apk。您也可以自行从源码生成。
- 雪暴安卓板局域网批量部署工具--局域网内批量安装xuebaoRtmpPush.apk工具
- 雪暴安卓推流应用局域网配置工具--搜索局域网内所有机器，并配置参数或更新推流程序。
- 雪暴安卓推流应用外网配置工具--配合服务器端的协议，将可以实现远程配置参数和执行推流程序的更新。
[安卓板与娃娃机指令交互说明] 当您决定不使用xuebaoRtmpPush或者使用第三方私有协议实现推流，文件夹包含了对接娃娃机主板的核心代码。方便您自己实现推流程序
[SimpleServer.c] 简单应用服务器c版本的源码。仅支持一娃娃机一玩家的简单转发，主要是为了演示核心逻辑。
[网络娃娃机主板对接协议.docx] 网络娃娃机相关的命令文档。例如，按下左右移动操作是发什么命令？下抓是什么命令？报故障时是什么命令？方便您的程序员在不使用以上范例的时候，自行发送命令使娃娃机可以操作。
更加详细请看WIKI

源码工程SimpleClient SimpleServer可以免费使用，修改及二次开发。雪暴公司对此源码不提供技术支持(会有少许的bug更新修复)。
SimpleClient中的视频播放器由大牛直播sdk提供。如果要商用，请联系它给予正式版的授权。您也可以根据自身团队情况去选择其他播放器端。比如腾讯SDK，开源的IJKPLAYER等等支持解码RTMP视频流的sdk都可以。
源码工程xuebaoRtmpPush则可以自由修改，但只限运行于雪暴公司提供的安卓板。rtmpPush应用的名字不能改动，因为是和推流模块授权绑定的。
SimpleClient中的操作指令推荐放服务器端。目前放在客户端只是为了用户看代码时，明确知道哪个操作对应哪个命令，所以才放客户端的。实际场景下，在客户端应该自行开发和服务器的协议。服务器自行转换成娃娃机可以操控的指令即可。这样才具有可行性。比如客户端发{"cmd":"move","dir":left,"userid":XXX,timeStamp:xxxx}.服务器端自行转换成 FE XX XX 01 XX XX 0C 32 02 XX...即可。
指令不能太频繁。不建议一秒往娃娃机发送10个以上的指令。
如果在操作娃娃机移动下抓开局的基本命令对接上仍存在困难,欢迎直接前来要求技术指导.
如果有潜在的bug也欢迎反馈。

安卓板刷机工具及固件（推荐使用4.4）--仅限于2017年以前拿到我们板子的客户。打开设置-关于平板电脑-版本号-如果不是20171221 则需要刷新本链接提供的固件。
链接：https://pan.baidu.com/s/1mi3ltKs 密码：wu39

daguye918 / wawaji

网络娃娃机

线上线下弹珠机

更多信息

About

Languages