Querying Calls

For many different use cases, such as video calls, livestreams, or audio rooms, you may want to search and filter calls based on different criteria, such as:

• Upcoming calls
• Calls that are currently live
• Popular livestreams or audio rooms with a link to the recording.

To facilitate these, the SDK provides methods which allows users to quickly perform sorting and filtering using the queryCalls() method on StreamVideo:

var calls = StreamVideo.instance.queryCalls(filterConditions: {});

Filtering

To filter calls, a map containing the fields and conditions must be supplied to queryCalls via the filterConditions parameter.

final result = await video.queryCalls(
  filterConditions: {
    "custom.flutterAudioRoomCall": true,
  },
);

In the above example, we filter all calls that contain the custom field flutterAudioRoomCall. Other filtering options include call type, members, and start times.

For instance, to find all livestreams on our application, we can set the type filter to livestream.

final result = await video.queryCalls(
  filterConditions: {
    "type": 'livestream',
  },
);

Filter expressions support multiple matching criteria, and it is also possible to combine filters. For more information, please visit the filter operators guide. The full list of options that you can filter by is listed in the table below.

Sorting

Similar to filtering, the SDK offers robust support for sorting, enabling sorting on the following fields:

• starts_at
• created_at
• updated_at
• ended_at
• type
• id
• cid

To add a sort, it is simple as specifying a list of sorts to the queryCalls function:

final result = await video.queryCalls(
  // ...
  sorts: [
    SortParamRequest(field: 'starts_at', direction: -1),
  ],
);

The queryCalls function can take multiple sort parameters, which can be combined with filtering to give you powerful control over the data in your application.

Watching calls

​ If you specify watch parameter as true, the SDK will create a subscription to the call data on the server and you’ll be able to receive updates in real-time.

The server will send updates to the client when the call data changes (for example, members are updated, a call session has started, etc…). This is useful for showing a live preview of who is in the call or building a call dashboard.

You can listen to call events via the StreamVideo.instance.events stream.