如何在Roku中使用POST方法并通过请求体传参从API获取数据？

Roku平台基于BrightScript实现网络请求，核心使用roHttpTransfer（Roku OS 10+推荐）或旧版roUrlTransfer完成POST请求，以下是具体实现步骤：

1. 构造请求体数据 #

根据API要求的格式准备请求体：

• JSON格式（主流）：将参数转为JSON字符串

  params = {
      "user_id": 12345,
      "action": "get_data",
      "filters": ["active", "recent"]
  }
  postBody = Json.Stringify(params)
  

• 表单格式（x-www-form-urlencoded）：拼接成键值对字符串

  postBody = "user_id=12345&action=get_data&filters=active,recent"
  

2. 初始化并配置HTTP请求对象 #

以推荐的roHttpTransfer为例：

http = CreateObject("roHttpTransfer")
http.SetUrl("https://your-target-api.com/endpoint")
http.SetRequest("POST") ' 指定请求方法为POST

3. 设置请求头 #

根据请求体格式添加对应Content-Type头：

• JSON格式：

  http.AddHeader("Content-Type", "application/json")
  

• 表单格式：

  http.AddHeader("Content-Type", "application/x-www-form-urlencoded")
  

可根据API需求添加其他头（如授权头）：

http.AddHeader("Authorization", "Bearer your_access_token")

4. 附加请求体并发送请求 #

异步请求（推荐，避免阻塞UI线程） #

http.SetPostBody(postBody)

port = CreateObject("roMessagePort")
http.SetMessagePort(port)
http.AsyncGetToString() ' 异步发送请求

' 监听响应消息
while true
    msg = wait(0, port)
    if type(msg) = "roUrlEvent" then
        responseCode = msg.GetResponseCode()
        if responseCode = 200 then
            ' 成功获取响应，解析数据
            responseStr = msg.GetString()
            responseData = Json.Parse(responseStr)
            print("API返回数据："; responseData)
            ' 这里处理业务逻辑
        else
            print("请求失败，响应码："; responseCode; "，错误信息："; msg.GetFailureReason())
        end if
        exit while
    end if
end while

同步请求（仅适合初始化等非UI阻塞场景） #

http.SetPostBody(postBody)
responseStr = http.GetToString()
responseCode = http.GetResponseCode()

if responseCode = 200 then
    responseData = Json.Parse(responseStr)
    ' 处理数据
else
    print("请求失败："; http.GetFailureReason())
end if

5. 关键注意事项 #

• 确保Roku设备有网络权限，且API地址在Roku的允许域名列表中（若需上架，需在开发者后台配置）
• 处理JSON解析异常：若响应不是合法JSON，Json.Parse会报错，建议用try-catch包裹
• 超时设置：可通过http.SetTimeout(10000)设置10秒超时，避免无限等待

内容的提问来源于stack exchange，提问作者Rahul Rathod