• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Introduction to AVSession Kit
2
3Audio and Video Session (AVSession) Kit provides the audio and video management service, which manages the playback behavior of all audio and video applications in the system in a unified manner. You can use the kit to quickly build unified audio and video display and control capabilities.
4
5## Capability Scope
6
7- Unified audio and video management: Audio and video applications access AVSession and send it application data (for example, the song that is being played and the playback state). Through a controller, the user can choose another application or device for playback.
8
9- Restricted audio background playback: After an audio application accesses AVSession, it can continue audio playback in the background. To use this feature, the application must also request a background task.
10
11## Highlights
12
13- Consistent user experience
14
15  Audio and video applications access AVSession and send it application data (for example, the song that is being played and the playback state).
16
17  Through a controller, the user can choose another application or device for playback.
18
19- Standardize background playback management
20
21  Through the controller, the background playback of applications is visible and controllable.
22
23  The system forcibly controls background playback. When an application that does not access AVSession switches to the background, its audio playback is forcibly paused. This prevents malicious applications from playing audio in the background.
24
25## Basic Concepts
26
27Be familiar with the following basic concepts before development:
28
29- AVSession
30
31  For AVSession, one end is the audio and video applications under control, and the other end is a controller (for example, Media Controller or AI Voice). AVSession provides a channel for information exchange between the application and controller.
32
33- Provider
34
35  An audio and video application that accesses the AVSession service. After accessing AVSession, the audio and video application must provide the media information, for example, the name of the item to play and the playback state, to AVSession. Through AVSession, the application also receives control commands from the controller and responds accordingly.
36
37- Controller
38
39  A system application that accesses AVSession to provide global control on audio and video playback behavior. Typical controllers are Media Controller and AI Voice. The following sections use Media Controller as an example of the controller. After accessing AVSession, the controller obtains the latest media information and sends control commands to the audio and video applications through AVSession.
40
41- AVSessionController
42
43  An object that controls the playback behavior of the provider. It obtains the playback information of the audio and video application and listens for the application playback changes to synchronize the AVSession information between the application and controller. The controller is the holder of an **AVSessionController** object.
44
45- AVSessionManager
46
47  An object that provides the capability of managing sessions. It can create an **AVSession** object, create an **AVSessionController** object, send control commands, and listen for session state changes.
48
49## AVSession Interaction Process
50
51AVSessions are classified into local AVSessions and distributed AVSessions.
52
53![AVSession Interaction Process](figures/avsession-interaction-process.png)
54
55- Local AVSession
56
57  Local AVSession establishes a connection between the provider and controller in the local device, so as to implement unified playback control and media information display for audio and video applications in the system.
58
59- Distributed AVSession
60
61  Distributed AVSession establishes a connection between the provider and controller in the cross-device scenario, so as to implement cross-device playback control and media information display for audio and video applications in the system. For example, you can project the content played on device A to device B and perform playback control on device B.
62
63## Constraints
64
65All audio and video applications that need to be played in the background must be connected to AVSession and background task management. Otherwise, audio playback is forcibly paused when such an application switches to the background.
66
67## Relationship with Related Kits
68
69To implement background playback, an application must use [Background Tasks Kit](../task-management/background-task-overview.md) to request a continuous task to avoid being suspended.
70