OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add tencent-tds/kuiklyui-ai --skill kuikly-network-and-json
Kuikly NetworkModule 网络请求与 JSONObject/JSONArray 数据处理助手。在Kuikly中发起网络请求、处理 JSON 数据、上传下载二进制等场景时使用。
npx skills add tencent-tds/kuiklyui-ai --skill kuikly-network-and-json
acquireModule<NetworkModule>(NetworkModule.MODULE_NAME) 获取（找不到时抛异常），或用 getModule<NetworkModule>(NetworkModule.MODULE_NAME) 安全获取（找不到返回 null）。推荐 lazy 缓存实例。LocalActivity.current.getPager() 获取 Pager 实例，再调用 pager.acquireModule<NetworkModule>(NetworkModule.MODULE_NAME)。在 ComposeContainer 类内部（非 @Composable 上下文）可直接调用 acquireModule。success，为 true 时才安全使用 data。失败时通过 errorMsg 和 response.statusCode（注意：Int? 可空）排查。httpRequest / httpRequestBinary 可指定 timeout（秒），默认 30。{"data": "原始内容"}，通过 data.optString("data") 获取。方法选择：
| 场景 | 方法 |
|---|---|
| 简单 GET（无自定义 headers） | requestGet(url, param, callback) |
| 简单 POST（无自定义 headers） | requestPost(url, param, callback) |
| 自定义 headers / Cookie / 超时 | httpRequest(url, isPost, param, headers, cookie, timeout, callback) |
完整方法签名和参数说明见 NetworkModule API 参考。
Kuikly DSL（在 Pager / ComposeView 中）：
Compose DSL（在 @Composable 函数中）：
Compose DSL（在 ComposeContainer 类内部）：
方法选择：
| 场景 | 方法 |
|---|---|
| 下载二进制（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。
使用 opt* 系列方法安全读取（不会抛异常，返回默认值）。
完整的 JSONObject/JSONArray API 列表见 JSON API 参考。
import com.tencent.kuikly.core.module.NetworkModule
import com.tencent.kuikly.compose.ui.platform.LocalActivity
import com.tencent.kuikly.core.pager.Pager
@Composable
fun MyScreen() {
val pager = LocalActivity.current.getPager() as Pager
val networkModule = pager.acquireModule<NetworkModule>(NetworkModule.MODULE_NAME)
// 使用 networkModule 发起请求...
}@Page("MyComposePage")
class MyComposePage : ComposeContainer() {
// ComposeContainer 继承自 Pager，可直接调用 acquireModule
private val networkModule by lazy(LazyThreadSafetyMode.NONE) {
acquireModule<NetworkModule>(NetworkModule.MODULE_NAME)
}
}networkModule.requestGet(
"https://example.com/api/data",
JSONObject().apply { put("key", "value") }
) { data, success, errorMsg, response ->
if (success) {
val name = data.optString("name")
val count = data.optInt("count")
} else {
val statusCode = response.statusCode // Int? 可能为 null
}
}networkModule.requestPost(
"https://example.com/api/submit",
JSONObject().apply {
put("username", "test")
put("password", "123456")
}
) { data, success, errorMsg, response ->
if (success) {
val result = data.optString("result")
}
}networkModule.httpRequest(
url = "https://example.com/api/data",
isPost = true,
param = JSONObject().apply { put("id", 1) },
headers = JSONObject().apply {
put("Content-Type", "application/json")
put("Authorization", "Bearer token")
},
cookie = "session_id=abc123",
timeout = 30
) { data, success, errorMsg, response ->
// response.statusCode - HTTP 状态码（Int?）
// response.headerFields - 响应头（JSONObject）
if (success) { /* 处理数据 */ }
}networkModule.requestGetBinary(
"https://example.com/file.png",
JSONObject()
) { data, success, errorMsg, response ->
if (success) {
val fileBytes: ByteArray = data
}
}networkModule.requestPostBinary(
"https://example.com/upload",
imageBytes
) { data, success, errorMsg, response ->
if (success) {
val responseBytes: ByteArray = data
}
}networkModule.httpRequestBinary(
url = "https://example.com/api/binary",
isPost = true,
bytes = uploadBytes,
param = JSONObject().apply { put("type", "image") },
headers = JSONObject().apply { put("Content-Type", "application/octet-stream") },
cookie = "session_id=abc123",
timeout = 60
) { data, success, errorMsg, response ->
if (success) {
val responseBytes: ByteArray = data
}
}val jsonObj = JSONObject(jsonString)
// 安全读取（不存在时返回默认值）
val str = jsonObj.optString("key") // 默认 ""
val num = jsonObj.optInt("key") // 默认 0
val innerObj = jsonObj.optJSONObject("nested") // JSONObject?
val array = jsonObj.optJSONArray("list") // JSONArray?
// 写入
jsonObj.put("key", "value")
// 遍历所有 key
for (key in jsonObj.keys()) { /* ... */ }val jsonArr = jsonObj.optJSONArray("list") ?: JSONArray()
for (i in 0 until jsonArr.length()) {
val item = jsonArr.optJSONObject(i) ?: continue
val name = item.optString("name")
}