network

网络服务

Functions
network.isLocalWiFiAvailable()
检查地 WIFI 网络是否可用
network.isInternetConnectionAvailable()
检查互联网连接是否可用
network.isHostNameReachable(hostname)
检查是否可以解析指定的主机名
network.getInternetConnectionStatus()
返回互联网连接状态值
network.createHTTPRequest(callback, url, method)
创建异步 HTTP 请求,并返回 cc.HTTPRequest 对象。

Functions

network.isLocalWiFiAvailable()

network.isLocalWiFiAvailable()

检查地 WIFI 网络是否可用

提示: WIFI 网络可用不代表可以访问互联网。

Returns

  • boolean 网络是否可用

network.isInternetConnectionAvailable()

network.isInternetConnectionAvailable()

检查互联网连接是否可用

通常,这里接口返回 3G 网络的状态,具体情况与设备和操作系统有关。

Returns

  • boolean 网络是否可用

network.isHostNameReachable()

network.isHostNameReachable(hostname)

检查是否可以解析指定的主机名


if network.isHostNameReachable("www.google.com") then -- 域名可以解析 end

注意: 该接口会阻塞程序,因此在调用该接口时应该提醒用户应用程序在一段时间内会失去响应。

Returns

  • boolean 主机名是否可以解析

network.getInternetConnectionStatus()

network.getInternetConnectionStatus()

返回互联网连接状态值

状态值有三种:

  • kCCNetworkStatusNotReachable: 无法访问互联网
  • kCCNetworkStatusReachableViaWiFi: 通过 WIFI
  • kCCNetworkStatusReachableViaWWAN: 通过 3G 网络

Returns

  • string 互联网连接状态值

network.createHTTPRequest()

network.createHTTPRequest(callback, url, method)

创建异步 HTTP 请求,并返回 cc.HTTPRequest 对象。


function onRequestFinished(event) local ok = (event.name == "completed") local request = event.request if not ok then -- 请求失败,显示错误代码和错误消息 print(request:getErrorCode(), request:getErrorMessage()) return end local code = request:getResponseStatusCode() if code ~= 200 then -- 请求结束,但没有返回 200 响应代码 print(code) return end -- 请求成功,显示服务端返回的内容 local response = request:getResponseString() print(response) end -- 创建一个请求,并以 POST 方式发送数据到服务端 local url = "http://www.mycompany.com/request.php" local request = network.createHTTPRequest(onRequestFinished, url, "POST") request:addPOSTValue("KEY", "VALUE") -- 开始请求。当请求完成时会调用 callback() 函数 request:start()

Returns

  • HTTPRequest 结果
update: 2014-09-19 16:07:27, generated by luadocx 1.3