kuikly-network-and-json
Kuikly NetworkModule 网络请求与 JSONObject/JSONArray 数据处理助手。在Kuikly中发起网络请求、处理 JSON 数据、上传下载二进制等场景时使用。
By tencent-tds · 365 installs
npx skills add tencent-tds/kuiklyui-ai --skill kuikly-network-and-json
Source repository · Upstream listing
Kuikly 网络请求
Contents
[Core Guidelines]( core guidelines)
[Workflow: HTTP Requests]( workflow http requests)
[Workflow: Binary Requests]( workflow binary requests)
[Workflow: Parsing JSON]( workflow parsing json)
[参考资源]( 参考资源)
Core Guidelines
获取 NetworkModule：
Kuikly DSL（Pager / ComposeView）： 直接调用 acquireModule<NetworkModule (NetworkModule.MODULE NAME) 获取（找不到时抛异常），或用 getModule<NetworkModule (NetworkModule.MODULE NAME) 安全获取（找不到返回 null）。推荐 lazy 缓存实例。
Compose DSL（@Composable 函数中）： 通过 LocalActivity.current.getPager() 获取 Pager 实例，再调用 pager.acquireModule<NetworkModule (NetworkModule.MODULE NAME) 。在 ComposeContainer 类内部（非 @Composable 上下文）可直接调用 acquireModule 。
检查 success： 回调中先判断 success ，为 true 时才安全使用 data 。失败时通过 errorMsg 和 response.statusCode （注意： Int? 可空）排查。
设置超时： httpRequest / httpRequestBinary 可指定 timeout （秒），默认 30。
非 JSON 回包： SDK 自动包装为 {"data": "原始内容"} ，通过 data.optString("data") 获取。
Workflow: HTTP Requests
方法选择：
场景 方法
简单 GET（无自定义 headers） requestGet(url, param, callback)
简单 POST（无自定义 headers） requestPost(url, param, callback)
自定义 headers / Cookie / 超时 httpRequest(url, isPost, param, headers, cookie, timeout, callback)
完整方法签名和参数说明见 [NetworkModule API 参考](./references/NETWORK API REFERENCE.md)。
获取 NetworkModule
Kuikly DSL（在 Pager / ComposeView 中）：
Compose DSL（在 @Composable 函数中）：
Compose DSL（在 ComposeContainer 类内部）：
GET 请求
POST 请求
通用请求（httpRequest）
Workflow: Binary Requests
方法选择：
场景 方法
下载二进制（GET） requestGetBinary(url, param, callback)
上传二进制（POST） requestPostBinary(url, bytes, callback)
自定义 headers / Cookie / 超时 httpRequestBinary(url, isPost, bytes, param, headers, cookie, timeout, callback)
requestPostBinary 内部 param 传 null。若需同时传 binary body 和 query 参数，使用 httpRequestBinary 。
下载二进制（GET）
上传二进制（POST）
通用二进制请求（httpRequestBinary）
Workflow: Parsing JSON
使用 opt 系列方法安全读取（不会抛异常，返回默认值）。
完整的 JSONObject/JSONArray API 列表见 [JSON API 参考](./references/JSON API REFERENCE.md)。
核心用法示例
JSONArray 遍历
参考资源
[NetworkModule API 参考](./references/NETWORK API REFERENCE.md)
[JSONObject/JSONArray API 参考](./references/JSON API REFERENCE.md)