Skip to main content

Recording Activities

Once you've completed camera calibration and neutral pose capture, you're ready to record movement activities.

Starting a Recording​

Swift:

let activity = try await service.record(activityNamed: "cmj-1", in: session)
print("Recording started: \(activity.id)")

TypeScript:

const activity = await service.record("cmj-1", session.id);
console.log("Recording started:", activity.id);

The activity name should be descriptive and unique within the session.

During Recording​

While recording:

  • Subject performs the movement activity
  • Ensure the subject stays within the camera's field of view
  • Maintain good lighting conditions
  • Avoid camera movement

Stopping the Recording​

Swift:

try await service.stopRecording(session)
print("Recording stopped")

TypeScript:

await service.stopRecording(session.id);
console.log("Recording stopped");

Checking Processing Status​

After stopping, the video is uploaded and processed:

Swift:

let status = try await service.getStatus(forActivity: activity)

switch status {
case .uploading(let progress):
    print("Uploading: \(progress)%")
case .processing:
    print("Processing video...")
case .ready:
    print("Ready for analysis!")
case .failed(let error):
    print("Processing failed: \(error)")
}

TypeScript:

let status = await service.getActivityStatus(activity.id);

while (status === "uploading" || status === "processing") {
  console.log("Status:", status);
  await new Promise(resolve => setTimeout(resolve, 2000));
  status = await service.getActivityStatus(activity.id);
}

if (status === "ready") {
  console.log("Ready for analysis!");
}

Best Practices​

Activity Naming​

Use descriptive names that help identify the activity later:

  • cmj-1, cmj-2 - Counter-movement jump attempts
  • squat-warmup - Warm-up squats
  • sprint-trial-1 - Sprint trial

Recording Duration​

  • Keep recordings focused on the activity
  • Start recording just before the movement begins
  • Stop shortly after the movement completes
  • Typical duration: 5-30 seconds

Multiple Attempts​

Record multiple attempts of the same activity:

for i in 1...3 {
    let activity = try await service.record(activityNamed: "cmj-\(i)", in: session)
    // Perform movement
    try await service.stopRecording(session)
}

Error Handling​

Swift:

do {
    let activity = try await service.record(activityNamed: name, in: session)
    // Recording in progress...
    try await service.stopRecording(session)
} catch {
    print("Recording failed: \(error)")
    // Handle error - maybe retry or alert user
}

TypeScript:

try {
  const activity = await service.record(name, session.id);
  // Recording in progress...
  await service.stopRecording(session.id);
} catch (error) {
  console.error("Recording failed:", error);
  // Handle error
}

Next Steps​

After your activity is processed and ready, proceed to Analysis to extract biomechanical insights.