add how to record the video stream

Author: yume-chan

.vscode/settings.json

@@ -15,6 +15,7 @@
         "libusb",
         "logcat",
         "muxer",
+        "muxing",
         "MVVM",
         "nohostname",
         "nouser",

docs/scrcpy/control/index.mdx

@@ -1,5 +1,7 @@
 # Control device
 
+import Version from "../version-span";
+
 Scrcpy supports various input events, including mouse, touch, keyboard, and physical buttons. The client sends input events to the server, which injects them into the device.
 
 There are three ways to create or send control messages, they provide the same set of methods:
@@ -15,6 +17,7 @@ There are three ways to create or send control messages, they provide the same s
 - Collapse panels: Collapse the notification and quick settings panels.
 - [Rotate device](./rotate.mdx): Change the device orientation.
 - Set clipboard: Set the device clipboard (only supports plain text).
+- <Version since="v3.0">[Reset video](./reset-video.mdx): Restart video capture and encoding.</Version>
 
 ## Using `@yume-chan/scrcpy`
 

docs/scrcpy/control/reset-video.mdx

@@ -0,0 +1,34 @@
+---
+sidebar_position: 12
+---
+
+# Reset video
+
+:::info
+
+Added in Scrcpy 3.0
+
+:::
+
+Restart video capture and encoding.
+
+Because a video must start with a configuration and keyframe to be decoded, sometimes you might want to manually restart video capture and encoding, which produces a new configuration packet and keyframe data packet immediately.
+
+For example, when you want to [save a video](../video/record.mdx) from a specific point, or stream the video to multiple players, and a new player is added.
+
+Reset video will cause a very small pause in the video stream, but it should be acceptable for most cases.
+
+## Usage
+
+```ts transpile
+import { AndroidKeyEventAction } from "@yume-chan/scrcpy";
+
+// Using `ScrcpyControlMessageSerializer`
+const message: Uint8Array = serializer.resetVideo();
+
+// Using `ScrcpyControlMessageWriter`
+await writer.resetVideo();
+
+// Using `AdbScrcpyClient`
+await client.controller!.resetVideo();
+```

docs/scrcpy/video/index.mdx

@@ -112,8 +112,8 @@ When the encoder is restarted, a new configuration packet will be generated and
 
 The `data` field contains the codec-specific configuration information:
 
-* H.264: Sequence Parameter Set (SPS) and Picture Parameter Set (PPS)
-* H.265: Video Parameter Set (VPS), Sequence Parameter Set (SPS), and Picture Parameter Set (PPS)
+* H.264: Sequence Parameter Set (SPS) and Picture Parameter Set (PPS) in Annex B format.
+* H.265: Video Parameter Set (VPS), Sequence Parameter Set (SPS), and Picture Parameter Set (PPS) in Annex B format.
 * AV1: The first 3 bytes of `AV1CodecConfigurationRecord` (https://aomediacodec.github.io/av1-isobmff/#av1codecconfigurationbox). The remaining configuration OBUs are in the next data packet.
 
 The client should handle this packet and update the decoder accordingly.