[关闭]
@lisaisacat 2020-01-28T13:34:50.000000Z 字数 6869 阅读 177

tsnet.so 高级函数库


使用方法

注意事项

平台 版本 备注 更新日期 下载
iOS v1.0.0 仅支持专业版和企业版 iOS-v1.0.0
安卓真机 v1.0.0 支持标准版和企业版 安卓真机-v1.0.0
安卓模拟器 v1.0.0 支持标准版和企业版 安卓模拟器-v1.0.0

函数:TSNETVersion 获取 tsnet.so 版本号

函数名称:获取扩展库版本

函数功能:用来判断获取扩展库版本号

函数方法

version = TSNETVersion()

参数 类型 说明
version string 版本号

脚本实例:

  1. require("tsnet")
  2. dialog("tsnet.so 版本号 : " .. TSNETVersion())

函数:http.setTimeout 设置超时时间

函数名称:设置请求超时时间

函数功能:设置 http/https 类型请求超时时间

函数方法

http.setTimeout(sec)

参数 类型 字段 说明
sec number 选填 超时时间,单位为秒

注意事项:

函数:http.get 发送 httpGET/httpsGET 请求

函数名称:发送 httpGET/httpsGET 请求

函数功能:发送 httpGET/httpsGET 类型请求

函数方法

status,header,content = http.get(url,tb)

参数 类型 字段 说明
url string 必填 请求 URL
tb table 选填 table 参数

table 参数介绍

参数 类型 字段 说明
headers table 选填 请求头部内容,本参数必须与请求体一起填写
params table 选填 字段对,会转换成 aaa=111&bbb=222 的形式
opts table 选填 保存返回数据及对返回值进行转码
postdata table 选填 需要发送的数据

opts 参数介绍

参数 类型 字段 说明
save string 选填 要保存返回数据的文件路径/文件下载保存的路径
charset string 选填 是否对返回值进行转码,gbk - 将 gbk 格式数据转换成 utf-8 格式数据,utf8 - 将 utf-8 格式数据转换成 gbk 格式数据
返回值 类型 说明
status number HTTP 状态码
header string 返回头部
content string 返回内容

脚本实例:

  1. require("tsnet")
  2. status,header,content = http.get("https://whois.pconline.com.cn/ip.jsp",{headers={aaa=123,cd=12},params={aaa=111,bbb=222},opts={save=userPath().."/res/1.txt",charset="gbk"}})
  3. dialog(status)
  1. require("tsnet")
  2. status,header,content = http.get("https://whois.pconline.com.cn/ip.jsp",{headers={aaa=123,cd=12},params={aaa=111,bbb=222},opts={charset="gbk"}})
  3. dialog(status)
  4. dialog(header)
  5. dialog(content)
  1. --下载文件
  2. require("tsnet")
  3. table = {
  4. pts = {
  5. save = userPath() .. '/res/TSLib.lua',
  6. charset = 'gbk'
  7. }
  8. }
  9. status,header,content = http.get("http://video.touchsprite.com/%E6%8F%92%E4%BB%B6%E5%87%BD%E6%95%B0%E5%BA%93/TSLib/1.3.2.1/TSLib.lua",table)
  10. if status == 200 then
  11. dialog("1")
  12. end

注意事项:

函数:http.post 发送 httpPOST/httpsPOST 请求

函数名称:发送 httpPOST/httpsPOST 请求

函数功能:发送 httpPOST/httpsPOS 类型请求

函数方法

status,header,content = http.post(url,tb)

参数 类型 字段 说明
url string 必填 请求 URL
tb table 选填 table 参数

table 参数介绍

参数 类型 字段 说明
headers table 选填 请求头部内容,本参数必须与请求体一起填写
params table 选填 字段对,会转换成 aaa=111&bbb=222 的形式
opts table 选填 保存返回数据及对返回值进行转码

opts 参数介绍

参数 类型 字段 说明
save string 选填 要保存返回数据的文件路径
charset string 选填 是否对返回值进行转码,gbk - 将 gbk 格式数据转换成 utf-8 格式数据,utf8 - 将 utf-8 格式数据转换成 gbk 格式数据
返回值 类型 说明
status number HTTP 状态码
header string 返回头部
content string 返回内容

脚本实例:

  1. require("tsnet")
  2. status,header,content = http.post("https://whois.pconline.com.cn/ip.jsp",{headers={aaa=123,cd=12},params={aaa=111,bbb=222},opts={save=userPath().."/res/1.txt",charset="gbk"}})
  3. dialog(status)
  1. require("tsnet")
  2. status,header,content = http.post("https://whois.pconline.com.cn/ip.jsp",{headers={aaa=123,cd=12},params={aaa=111,bbb=222},opts={charset="gbk"}})
  3. dialog(status)
  4. dialog(header)
  5. dialog(content)

注意事项:

函数:ftp.init 连接 FTP 服务器

函数名称:连接 FTP 服务器

函数功能:连接 FTP 服务器,使用 FTP 功能前必须先连接

函数方法

ftp.init(url,username,password)

参数 类型 字段 说明
url string 必填 服务器地址,示例:"1.1.1.1"
username string 必填 用户名,服务器登录用户名
password string 必填 密码,服务器登录密码

函数:ftp.clean() 断开 FTP 连接

函数名称:断开 FTP 连接

函数功能:断开 FTP 连接,FTP 功能使用结束后必须调用

函数方法

ftp.clean()

函数:ftp.setTimeout 设置 FTP 超时时间

函数名称:设置 FTP 超时时间

函数功能:设置 FTP 超时时间,超时后执行下一步防止阻塞

函数方法

ftp.setTimeout(sec)

参数 类型 字段 说明
sec number 选填 超时时间,单位为秒

注意事项:

函数:ftp.mkdir 创建文件夹

函数名称:创建文件夹

函数功能:在服务器指定目录下创建文件夹

函数方法

ret,msg = ftp.mkdir(filePath)

参数 类型 字段 说明
filePath string 必填 文件夹路径及文件夹名
返回值 类型 说明
ret string 1 - 创建成功,0 - 创建失败
msg string 创建失败返回失败原因

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg = ftp.mkdir("/test")
  9. if ret == 1 then
  10. dialog("创建成功")
  11. else
  12. dialog("创建失败".."\n".."失败原因:"..msg)
  13. end

注意事项:

函数:ftp.rmdir 删除文件夹

函数名称:删除文件夹

函数功能:在服务器删除指定的文件夹

函数方法

ret,msg = ftp.rmkdir(filePath)

参数 类型 字段 说明
filePath string 必填 删除指定目录下的文件夹
返回值 类型 说明
ret string 1 - 删除成功,0 - 删除失败
msg string 删除失败返回失败原因

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg = ftp.rmdir("/test")
  9. if ret == 1 then
  10. dialog("删除成功")
  11. else
  12. dialog("删除失败".."\n".."失败原因:"..msg)
  13. end

注意事项:

函数:ftp.upload 上传文件

函数名称:上传文件

函数功能:上传本地文件到服务器

函数方法

ret,msg = ftp.upload(localfilepath,severfilepath)

参数 类型 字段 说明
filePath string 必填 本地文件路径
filePath string 必填 FTP 文件路径
返回值 类型 说明
ret string 1 - 上传成功,0 - 上传失败
msg string 上传失败返回失败原因

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg = ftp.upload(userPath().."/res/1.png","/test/1.png")
  9. if ret == 1 then
  10. dialog("上传成功")
  11. else
  12. dialog("上传失败".."\n".."失败原因:"..msg)
  13. end
  14. ftp.clean()

注意事项:

函数:ftp.download 下载文件

函数名称:下载文件

函数功能:下载服务器文件到本地

函数方法

ret,msg = ftp.download(localfilepath,severfilepath)

参数 类型 字段 说明
filePath string 必填 本地文件路径
filePath string 必填 FTP 文件路径
返回值 类型 说明
ret string 1 - 下载成功,0 - 下载失败
msg string 下载失败返回失败原因

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg = ftp.download(userPath().."/res/1.png","/test/1.png")
  9. if ret == 1 then
  10. dialog("下载成功")
  11. else
  12. dialog("下载失败".."\n".."失败原因:"..msg)
  13. end
  14. ftp.clean()

注意事项:

函数:ftp.list 获取文件列表文件

函数名称:获取文件列表文件

函数功能:获取服务器指定目录下的文件列表

函数方法

ret,msg,list = ftp.list(filepath)

参数 类型 字段 说明
filePath string 必填 文件目录下的所有文件列表
返回值 类型 说明
ret string 1 - 获取成功,0 - 获取失败
msg string 获取失败返回失败原因
list table 获取的文件列表

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg,list = ftp.list("/test/")
  9. if ret == 1 then
  10. if list then
  11. allFilestr = ""
  12. for i,v in pairs(list) do
  13. allFilestr=v.."\n"..allFilestr;
  14. end
  15. dialog("获取成功:"..allFilestr)--打印文件夹内所有文件列表
  16. end
  17. else
  18. dialog("获取失败".."\n".."失败原因:"..msg)
  19. end
  20. ftp.clean()

注意事项:

函数:ftp.rename 重命名文件

函数名称:重命名文件

函数功能:重命名服务器上指定目录的文件

函数方法

ret,msg,list = ftp.rename(oldfilepath,filepath)

参数 类型 字段 说明
oldfilepath string 必填 待重命名文件名
filepath string 必填 新文件名
返回值 类型 说明
ret string 1 - 获取成功,0 - 获取失败
msg string 获取失败返回失败原因
list table 获取的文件列表

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg = ftp.rename("/test/123.png","/test/223.png")
  9. if ret == 1 then
  10. dialog("重命名成功")
  11. else
  12. dialog("重命名失败".."\n".."失败原因:"..msg)
  13. end
  14. ftp.clean()

注意事项:

函数:ftp.delete 删除文件

函数名称:删除文件

函数功能:删除指定文件

函数方法

ret,msg = ftp.delete(filepath)

参数 类型 字段 说明
filePath string 必填 文件路径下的文件,具体文件需要加上扩展名
返回值 类型 说明
ret string 1 - 删除成功,0 - 删除失败
msg string 删除失败返回失败原因

脚本实例:

  1. --脚本仅供参考不可直接使用
  2. require("tsnet")
  3. ftp.setTimeout(50)
  4. local url ="1.1.1.1"
  5. local username ="ceshi"
  6. local password ="ceshi"
  7. ftp.init(url,username,password)
  8. ret,msg = ftp.delete("/test/1.png")
  9. if ret == 1 then
  10. dialog("删除成功")
  11. else
  12. dialog("删除失败".."\n".."失败原因:"..msg)
  13. end
  14. ftp.clean()

注意事项:

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注