v2.4.2

Author: 001ProMax

Scripting Documentation/audio_player/en.md

@@ -892,8 +892,8 @@
           "zh": "手势"
         },
         "subtitle": {
-          "en": "Define interactions from taps, clicks, and swipes to fine-grained gestures.",
-          "zh": "定义从轻点、点击、滑动到更精细手势的交互方式。"
+          "en": "This interface provides a gesture system similar to SwiftUI, allowing any view to respond to touch interactions such as tapping, long pressing, dragging, rotating, and magnifying.",
+          "zh": "该接口提供了类似于 SwiftUI 的手势系统，允许任何视图响应触摸交互，如轻点、长按、拖拽、旋转和放大。"
         },
         "keywords": [
           "tap",
@@ -907,7 +907,6 @@
           "双击",
           "长按"
         ],
-        "example": "views/gestures/index",
         "readme": "views/gestures/"
       },
       {
@@ -2240,6 +2239,10 @@
           "en": "This view modifier allows you to chain multiple modifiers together, supporting the same modifier being used multiple times in the same view.",
           "zh": "该修饰符可用于连续调用多个修饰符，支持同一个修饰符在同一个视图中多次使用。"
         },
+        "keywords": [
+          "modifiers",
+          "ViewModifiers"
+        ],
         "readme": "view_modifiers/modifiers/"
       }
     ]
@@ -2342,6 +2345,17 @@
         },
         "readme": "data/"
       },
+      {
+        "title": {
+          "en": "Encoding",
+          "zh": "编码"
+        },
+        "subtitle": {
+          "en": "This type defines a set of supported character encodings.",
+          "zh": "该类型定义了支持的字符编码集。"
+        },
+        "readme": "encoding/"
+      },
       {
         "title": {
           "en": "UIImage",
@@ -2620,6 +2634,51 @@
         },
         "readme": "oauth2/"
       },
+      {
+        "title": {
+          "en": "URLSession",
+          "zh": "URLSession（网络会话）"
+        },
+        "subtitle": {
+          "en": "This native iOS interface allows you to perform network requests, manage HTTP headers, and handle HTTP responses.",
+          "zh": "iOS原生的URLSession，允许你进行网络请求，管理HTTP头部和处理HTTP响应。"
+        },
+        "children": [
+          {
+            "title": {
+              "en": "BackgroundURLSession",
+              "zh": "后台网络会话"
+            },
+            "subtitle": {
+              "en": "This interface provides the ability to initiate, resume, and query background download and upload tasks.",
+              "zh": "该接口提供发起、恢复与查询「后台可持续」的下载与上传任务的能力"
+            },
+            "readme": "url_session/background_url_session/"
+          },
+          {
+            "title": {
+              "en": "URLSessionDownloadTask",
+              "zh": "下载任务"
+            },
+            "subtitle": {
+              "en": "Represents a download task instance that can be performed in the foreground or background, and can be resumed after the script is terminated.",
+              "zh": "表示一个后台下载任务实例，用于在前台或后台下载文件，并可在脚本被终止后继续运行。"
+            },
+            "readme": "url_session/url_session_download_task/"
+          },
+          {
+            "title": {
+              "en": "URLSessionUploadTask",
+              "zh": "上传任务"
+            },
+            "subtitle": {
+              "en": "Represents an upload task instance that can be performed in the foreground or background, and can be resumed after the script is terminated.",
+              "zh": "表示一个后台上传任务实例，用于在前台或后台上传文件，并可在脚本被终止后继续运行。"
+            },
+            "readme": "url_session/url_session_upload_task/"
+          }
+        ]
+      },
       {
         "title": {
           "en": "App Events",
@@ -2702,20 +2761,20 @@
       },
       {
         "title": {
-          "en": "Clipboard",
+          "en": "Pasteboard",
           "zh": "剪贴板"
         },
         "subtitle": {
-          "en": "Read and set the clipboard.",
-          "zh": "读取并设置剪贴板内容。"
+          "en": "This namspace provides a complete interface for reading, writing, and observing system pasteboard  changes.",
+          "zh": "该命名空间提供了读取、写入和观察剪贴板变化的完整接口。"
         },
         "keywords": [
           "copy",
-          "pasteboard",
+          "clipboard",
           "复制",
           "粘贴板"
         ],
-        "example": "clipboard/index"
+        "readme": "pasteboard/"
       },
       {
         "title": {
@@ -2990,6 +3049,17 @@
         },
         "readme": "audio_recorder/"
       },
+      {
+        "title": {
+          "en": "AVMetadataItem",
+          "zh": "AVMetadataItem"
+        },
+        "subtitle": {
+          "en": "AVMetadataItem is a class that represents a metadata item in an audio or video asset.",
+          "zh": "AVMetadataItem 是一个类，表示音频或视频资源中的元数据项。"
+        },
+        "readme": "av_metadata_item/"
+      },
       {
         "title": {
           "en": "Audio Player",
@@ -3528,6 +3598,18 @@
             "readme": "bluetooth/peripheral_manager/"
           }
         ]
+      },
+      {
+        "pro": true,
+        "title": {
+          "en": "BackgroundKeeper",
+          "zh": "后台保活"
+        },
+        "subtitle": {
+          "en": "This interface provides methods for keeping the Scripting app running in the background.",
+          "zh": "该接口提供了用于保持 Scripting 应用在后台运行的方法。"
+        },
+        "readme": "background_keeper/"
       }
     ]
   }

Scripting Documentation/audio_player/zh.md

@@ -159,11 +159,17 @@ console.log(prefersNoInterruptions) // Example: false
 
 ### 7. **Session Activation**
 
-#### `setActive(active: boolean)`
-Activate or deactivate the shared audio session.
+#### `setActive(active: boolean, options?: AudioSessionSetActiveOptions[])`
+Activate or deactivate the shared audio session with optional options.
+
+- `active`: Set to `true` to activate the session, `false` to deactivate it.
+- `options`: An array of optional activation options, such as 'interruptSpokenAudioAndMixWithOthers'.
 
 ```typescript
-await SharedAudioSession.setActive(true)
+await SharedAudioSession.setActive(
+  true,
+  ['notifyOthersOnDeactivation']
+)
 ```
 
 ---
@@ -188,37 +194,40 @@ await SharedAudioSession.setPrefersNoInterruptionsFromSystemAlerts(true)
 
 ## Enumerations
 
+### **AudioSessionSetActiveOptions**
+Optional activation options:
+- `'notifyOthersOnDeactivation'`: Notify other audio sessions when deactivating the shared audio session.
+
 ### **AudioSessionCategory**
 Defines the session's audio category:
-- `'ambient'`
-- `'multiRoute'`
-- `'playAndRecord'`
-- `'playback'`
-- `'record'`
-- `'soloAmbient'`
+- `'ambient'`: Ambient audio, such as background music or ambient sounds.
+- `'multiRoute'`: Multi-route audio, such as routing distinct streams of audio data to different output devices at the same time.
+- `'playAndRecord'`: Play and record audio, such as voice chat or video conferencing.
+- `'playback'`: Playback audio, such as music or sound effects.
+- `'record'`: Recording audio, such as voice chat or video conferencing.
+- `'soloAmbient'`: Solo ambient audio, such as background music or ambient sounds.
 
 ### **AudioSessionCategoryOptions**
 Optional behaviors for audio categories:
-- `'mixWithOthers'`
-- `'duckOthers'`
-- `'interruptSpokenAudioAndMixWithOthers'`
-- `'allowBluetooth'`
-- `'allowBluetoothA2DP'`
-- `'allowAirPlay'`
-- `'defaultToSpeaker'`
-- `'overrideMutedMicrophoneInterruption'`
+- `'mixWithOthers'`: Mix with other audio sessions.
+- `'duckOthers'`: Duck other audio sessions.
+- `'interruptSpokenAudioAndMixWithOthers'`: Interrupt spoken audio and mix with others.
+- `'allowBluetooth'`: Allow Bluetooth audio.
+- `'allowBluetoothA2DP'`: Allow Bluetooth A2DP audio.
+- `'allowAirPlay'`: Allow AirPlay audio.
+- `'defaultToSpeaker'`: Default to speaker, even if headphones are connected.
+- `'overrideMutedMicrophoneInterruption'`: Override muted microphone interruption.
 
 ### **AudioSessionMode**
 Specifies the session's mode:
-- `'default'`
-- `'gameChat'`
-- `'measurement'`
-- `'moviePlayback'`
-- `'spokenAudio'`
-- `'videoChat'`
-- `'videoRecording'`
-- `'voiceChat'`
-- `'voicePrompt'`
+- `'default'`: Default mode.
+- `'gameChat'`: Game chat mode.
+- `'measurement'`: Measurement mode, such as audio input or output.
+- `'moviePlayback'`: Movie playback mode, such as movie content.
+- `'spokenAudio'`: Spoken audio mode, such as voice chat.
+- `'videoChat'`: Video chat mode, such as video conferencing.
+- `'videoRecording'`: Video recording mode, such as video conferencing.
+- `'voicePrompt'`: Voice prompt mode, such as text-to-speech.
 
 ### **AudioSessionInterruptionType**
 Specifies the type of interruption:

Scripting Documentation/clipboard/index.tsx

@@ -161,11 +161,14 @@ console.log(prefersNoInterruptions) // 示例输出：false
 
 ### 7. **会话激活**
 
-#### `setActive(active: boolean)`
-激活或停用共享音频会话。
+#### `setActive(active: boolean, options?: AudioSessionSetActiveOptions[])`
+激活或停用共享音频会话，可指定激活选项。
 
 ```typescript
-await SharedAudioSession.setActive(true)
+await SharedAudioSession.setActive(
+  true,
+  ['notifyOthersOnDeactivation']
+)
 ```
 
 ---
@@ -190,6 +193,10 @@ await SharedAudioSession.setPrefersNoInterruptionsFromSystemAlerts(true)
 
 ## 枚举（Enumerations）
 
+### **AudioSessionSetActiveOptions**
+定义激活选项：
+- `'notifyOthersOnDeactivation'`
+
 ### **AudioSessionCategory**
 定义音频会话的类别：
 - `'ambient'`

Scripting Documentation/doc.json

@@ -5,7 +5,7 @@ The Scripting app supports a set of navigation-related view modifiers that enabl
 ## `navigationTitle`
 
 ```ts
-navigationTitle?: string | VirtualNode
+navigationTitle?: string
 ```
 
 Specifies the navigation title of the view.
@@ -15,10 +15,6 @@ Specifies the navigation title of the view.
 * On **iOS**, the navigation title appears in the navigation bar when the view is part of a navigation stack.
 * On **iPadOS**, the title of the primary navigation destination is also used as the app window's title in the App Switcher.
 
-### Usage
-
-You can provide either a plain string or a `VirtualNode` (such as a `Text` component) for advanced formatting.
-
 ---
 
 ## `navigationBarTitleDisplayMode`

Scripting Documentation/shared_audio_session/en.md

@@ -5,8 +5,7 @@ Scripting App 提供了一组用于配置导航行为的视图修饰符，允许
 ## `navigationTitle`
 
 ```ts
-navigationTitle?: string | VirtualNode
-```
+navigationTitle?: string
 
 设置当前视图在导航栏中显示的标题。
 
@@ -15,10 +14,6 @@ navigationTitle?: string | VirtualNode
 * 在 **iOS** 中，当视图被嵌套在导航栈中时，所设置的标题将显示在导航栏中。
 * 在 **iPadOS** 中，主导航目的地的标题也会在多任务切换界面中显示为窗口的标题。
 
-### 使用方式
-
-可传入字符串（`string`）用于简单标题，或传入 `VirtualNode`（如 `Text`）以实现更复杂的格式控制。
-
 ---
 
 ## `navigationBarTitleDisplayMode`

Scripting Documentation/shared_audio_session/zh.md

@@ -189,6 +189,16 @@ Specifies how many lines of text can display. You can provide:
 
 ---
 
+### `lineSpacing`
+
+Sets the spacing between lines, in pixels.
+
+```tsx
+<Text lineSpacing={5}>Line spacing set to 5 pixels</Text>
+```
+
+---
+
 ### `multilineTextAlignment`
 
 Sets the text alignment for multi-line text: `"leading"`, `"center"`, or `"trailing"`.