List Screen Records

ScreenRecordFilterRequest filterRequest = ScreenRecordFilterRequest.of(
        ScreenRecordFilter.CREATED_AT,
        "2026-07-28T00:00:00Z",
        SearchOperation.GREATER_THAN
);

PageDto<ScreenRecord> records = client.sessions().screenRecords(
        "session-123",
        ScreenRecordPaginationRequest.builder()
                .filters(Collections.singletonList(filterRequest))
                .page(0)
                .size(20)
                .build()
);

{
  "size": 20,
  "page": 0,
  "totalPages": 1,
  "totalElements": 1,
  "data": [
    {
      "fileKey": "recording-segment-001",
      "filePath": "screen-records/session-123/recording-001.ts",
      "downloadUrl": "https://storage.example/temporary-recording-segment-url",
      "createdAt": "2026-07-28T10:00:00Z",
      "updatedAt": "2026-07-28T10:15:00Z",
      "duration": 9.5
    }
  ]
}

import io.testinium.devicepark.model.common.PageDto;
import io.testinium.devicepark.model.common.SearchOperation;
import io.testinium.devicepark.model.sessions.DeviceSessionFilterRequest;
import io.testinium.devicepark.model.sessions.DeviceSessionRequest;
import io.testinium.devicepark.model.sessions.Session;
import io.testinium.devicepark.model.sessions.SessionFilter;

import java.util.Collections;

DeviceSessionFilterRequest sessionFilter = DeviceSessionFilterRequest.of(
        SessionFilter.SESSION,
        "session-123",
        SearchOperation.EQUAL
);

PageDto<Session> page = client.sessions().list(
        DeviceSessionRequest.builder()
                .filters(Collections.singletonList(sessionFilter))
                .page(0)
                .size(1)
                .build()
);

Session session = page.data().stream()
        .findFirst()
        .orElseThrow(() -> new IllegalStateException("Session was not found"));

if (!"CLOSED".equals(session.state()) || session.videoRecordUrl() == null) {
    throw new IllegalStateException("The session recording is not ready yet");
}

System.out.println(session.videoRecordUrl());

import io.testinium.devicepark.model.sessions.Session;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

static String readHlsPlaylist(Session session, String bearerToken) throws IOException {
    if (session.videoRecordUrl() == null) {
        throw new IllegalStateException("The session recording is not ready yet");
    }

    URL hlsUrl = new URL(session.videoRecordUrl());
    HttpURLConnection connection = (HttpURLConnection) hlsUrl.openConnection();
    connection.setRequestMethod("GET");
    connection.setRequestProperty("Accept", "application/vnd.apple.mpegurl");
    connection.setRequestProperty("Authorization", "Bearer " + bearerToken);

    int status = connection.getResponseCode();
    if (status != HttpURLConnection.HTTP_OK) {
        throw new IOException("HLS playlist request failed with HTTP " + status);
    }

    StringBuilder playlist = new StringBuilder();
    try (BufferedReader reader = new BufferedReader(
            new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) {
        String line;
        while ((line = reader.readLine()) != null) {
            playlist.append(line).append('\n');
        }
    } finally {
        connection.disconnect();
    }

    if (playlist.indexOf("#EXTM3U") != 0) {
        throw new IOException("Device Park did not return an HLS playlist");
    }

    return playlist.toString();
}

npm install hls.js

import Hls from "hls.js";
import type { Session } from "@device-park/public-sdk";

function playHlsRecording(
  session: Session,
  bearerToken: string,
  video: HTMLVideoElement
): Hls {
  if (!session.videoRecordUrl) {
    throw new Error("The session recording is not ready yet");
  }

  const hls = new Hls({
    xhrSetup(xhr) {
      // hls.js applies this header to the playlist and media-segment requests.
      xhr.setRequestHeader("Authorization", `Bearer ${bearerToken}`);
    }
  });

  hls.loadSource(session.videoRecordUrl);
  hls.attachMedia(video);
  return hls;
}

const video = document.querySelector<HTMLVideoElement>("#recording");
if (!video) {
  throw new Error("Video element was not found");
}

const bearerToken = await getBearerTokenFromYourBackend();
const hls = playHlsRecording(session, bearerToken, video);

// Call hls.destroy() when the component or page is disposed.

<video id="recording" controls playsinline></video>