How to Use

### Authorize Interactive Mode

- Apply for an authorization code from the developer platform to enable Interactive Mode, or contact Pingxingyun Business for activation.

### Function Description

Interactive Mode can be used directly through the frontend page or integrated through the API.

### Application Operation Logic

- Interactive Mode is divided into **Demonstration Mode** and **Interactive Mode**. In Demonstration Mode, one user operates while others watch. The controller has operational authority and can transfer control to subordinate clients. In Interactive Mode, multiple users can operate simultaneously.
- The controller enters the application first and generates a password for viewers to join the application.
- Subordinate clients must enter either the password or the controller's `taskId` to access the application. If the controller enters the application using a password, subordinate clients must also use the same password.
- When the controller exits the application, all subordinate clients also exit. However, when a subordinate client exits, the controller is not affected.
- For streaming resources, the controller occupies the GPU encoding channel, audio/video ports, and network bandwidth. Subordinate clients do not occupy encoding channels, but they still consume audio/video ports and network bandwidth.

### Interactive Mode Settings

- In the backend application management page, you can configure whether the player list is displayed.
- In Interactive Mode, the client shows the player list in the upper-right corner, allowing users to copy the password, view connected players, and share the link.

### Sharing Feature

- Modify the value of `pxy.client.share-url` in the main node configuration file:
  - `true`: Display the share button
  - `false`: Hide the share button
- If encrypted access is enabled for the workspace to which the application belongs, the share button will not be displayed.