I finished my first native plug-in for Solar2d last night! It allows you to create a websocket server in your Lua code on iOS, Android, TVOS, Mac, and their respective simulators. It even works in the Corona simulator. HTML5 is obviously not supported because you can host a server in a browser. Windows (builds and simulator) is not yet supported because I don’t have a Windows computer on me at the moment, and I might have to find another c library to make it happen (my current implementation depends on unix-styled APIs).
Using it is simple. Here’s an example of a server and a client implementation on the same device.
local SolarWebSockets = require "plugin.solarwebsockets"
local message = display.newText("debug messages here", 120, 320, nil, 6)
local clients = {}
local json = require("json")
local function wsListener( event )
message.text = json.encode(event)
if event.isServer then
if event.name == "join" then
print("join", "clients #", #event.clients)
print(event.clientId)
print(event.clientIp)
clients = event.clients
for i=1, #event.clients do
print(
"client "..tostring(i),
tostring(event.clients[i]),
tostring(event.clients[i].clientId),
tostring(event.clients[i].clientIp)
)
end
end
if event.name == "message" then
print("got message")
print(event.clientId)
print(event.clientIp)
print(event.message)
SolarWebSockets.sendClient(event.clientId,"echo "..event.message)
SolarWebSockets.sendAllClients("someone said "..event.message)
if event.message == "kick" then
local clientToKick = clients[1]
if clientToKick then
print("going to kick "..tostring(clientToKick.clientId))
SolarWebSockets.kick(clientToKick.clientId)
end
end
end
if event.name == "leave" then
print("leave","clients #", #event.clients)
print(event.clientId)
print(event.clientIp)
clients = event.clients
for i=1, #event.clients do
print(
"client "..tostring(i),
tostring(event.clients[i]),
tostring(event.clients[i].clientId),
tostring(event.clients[i].clientIp)
)
end
end
elseif event.isClient then
if event.name == "join" then
-- connected
end
if event.name == "message" then
print("got message from server")
print(event.message)
-- send reply
-- SolarWebSockets.send("reply "..event.message)
end
if event.name == "leave" then
-- not connected anymore
print("left server")
print("error code: ",tostring(event.errorCode))
print("error message: ",tostring(event.errorMessage))
end
end
end
SolarWebSockets.init( wsListener )
local widget = require("widget")
widget.newButton({
left = 50,
width = 100,
top = 50,
label = "Start Server",
shape = "rect",
onRelease = function()
SolarWebSockets.startServer()
end,
fillColor = { default={ 1, 1, 1 }, over={ .2, 0.2, 0.2 } }
})
SolarWebSockets.startServer()
widget.newButton({
left = 50,
width = 100,
top = 150,
label = "Kill Server",
shape = "rect",
onRelease = function()
SolarWebSockets.killServer()
end,
fillColor = { default={ 1, 1, 1 }, over={ .2, 0.2, 0.2 } }
})
widget.newButton({
left = 50,
width = 100,
top = 250,
label = "Kick someone",
shape = "rect",
onRelease = function()
local clientToKick = clients[1]
if clientToKick then
print("going to kick "..tostring(clientToKick.clientId))
SolarWebSockets.kick(clientToKick.clientId)
end
end,
fillColor = { default={ 1, 1, 1 }, over={ .2, 0.2, 0.2 } }
})
-- client
widget.newButton({
left = 150,
width = 100,
top = 50,
label = "Connect to Server",
shape = "rect",
onRelease = function()
-- wss not supported on iOS...yet
SolarWebSockets.connect("wss://echo.websocket.org")
end,
fillColor = { default={ 1, 1, 1 }, over={ .2, 0.2, 0.2 } }
})
widget.newButton({
left = 150,
width = 100,
top = 150,
label = "SendMessage",
shape = "rect",
onRelease = function()
SolarWebSockets.sendServer("sample message")
end,
fillColor = { default={ 1, 1, 1 }, over={ .2, 0.2, 0.2 } }
})
widget.newButton({ left = 150,
width = 100,
top = 250,
label = "Disconnect",
shape = "rect",
onRelease = function()
SolarWebSockets.disconnect()
end,
fillColor = { default={ 1, 1, 1 }, over={ .2, 0.2, 0.2 } }
})
And you just include it like this
plugins = {
["plugin.solarwebsockets"] =
{
publisherId = "io.joehinkle",
},
},
I’m using this for local multiplayer games. It’s really solid from my tests so far, as I’m using websocket server implementations in C and Java (for Android).
I’m going to open source this soon and see if I can get it on the Solar2D direction also. Hope you guys like it or find use.
