1# Local AVSession Overview 2 3## Interaction Process 4 5For a local AVSession, the data sources are on the local device. The figure below illustrates the interaction process. 6 7 8 9This process involves two roles: provider and controller. 10 11In the local AVSession, the provider exchanges information with the controller through AVSessionManager. 12 131. The provider creates an **AVSession** object through AVSessionManager. 14 152. Through the **AVSession** object, the provider sets session metadata (such as the asset ID, title, and duration) and playback attributes (such as the playback state, speed, and position). 16 173. The controller creates an **AVSessionController** object through AVSessionManager. 18 194. Through the **AVSessionController** object, the controller listens for changes of the session metadata and playback attributes. 20 215. Through the **AVSessionController** object, the controller sends control commands to the **AVSession** object. 22 236. Through the **AVSession** object, the provider listens for the control commands, for example, play, playNext, fastForward, and setSpeed, from the controller. 24 25## AVSessionManager 26 27AVSessionManager 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. 28 29Unlike the **AVSession** and **AVSessionController** objects, AVSessionManager is not a specific object, but the root namespace of AVSessions. You can import AVSessionManager as follows: 30 31```ts 32import AVSessionManager from '@ohos.multimedia.avsession'; 33``` 34 35All the APIs in the root namespace can be used as APIs of AVSessionManager. 36 37The code snippet below shows how the provider creates an **AVSession** object by using AVSessionManager: 38 39```ts 40// Create an AVSession object. 41let context: Context = this.context; 42async function createSession() { 43 let session: AVSessionManager.AVSession = await AVSessionManager.createAVSession(context, 'SESSION_NAME', 'audio'); 44 console.info(`session create done : sessionId : ${session.sessionId}`); 45} 46``` 47 48The code snippet below shows how the controller creates an **AVSessionController** object by using AVSessionManager: 49 50```ts 51// Create an AVSessionController object. 52async function createController() { 53 // Obtain the descriptors of all live AVSession objects. 54 let descriptorsArray: Array<AVSessionManager.AVSessionDescriptor> = await AVSessionManager.getAllSessionDescriptors(); 55 if (descriptorsArray.length > 0) { 56 // For demonstration, the session ID of the first descriptor is used to create the AVSessionController object. 57 let sessionId: string = descriptorsArray[0].sessionId; 58 let avSessionController: AVSessionManager.AVSessionController = await AVSessionManager.createController(sessionId); 59 console.info(`controller create done : sessionId : ${avSessionController.sessionId}`); 60 } 61} 62``` 63 64For more information about AVSessionManager APIs, see [API Reference](../reference/apis/js-apis-avsession.md). 65
