Links

• Index

Modules

• audio
• cocos2dx
• crypto
• debug
• device
• display
• filter
• functions
• init
• json
• luaj
• luaoc
• network
• scheduler
• shortcodes
• transition
• ui

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 结果