⏱ Video Playback Replay Scheduler

Smart scheduling for reliable, cost-controlled video playback monitoring.

Video Playback Replay Scheduler is a lightweight orchestration Actor that decides when and where video playback checks should be repeated. It is designed to work alongside a playback verification Actor (such as Video Playback Monitor) to enable long-term, region-aware monitoring workflows.

This Actor does not open browsers or play videos itself. Its sole purpose is to schedule playback checks intelligently and responsibly.

---

✅ Why use this Actor?

Because running playback checks blindly is expensive and noisy.

This Actor helps you:

• avoid unnecessary rechecks
• space out monitoring runs intelligently
• rotate regions automatically
• respect local time zones
• enforce daily and per-session limits
• keep monitoring costs predictable

If you care about reliability over time, this Actor belongs in your workflow.

---

🔍 What this Actor does

For each run, the Actor:

1. Reads historical playback verification results

2. Groups results by session identifier

3. Applies configurable rules such as:

   • minimum days between rechecks
   • maximum rechecks per session
   • daily execution limits

4. Automatically maps countries to local time zones

5. Schedules new playback verification runs only during reasonable local hours

6. Triggers playback verification Actors asynchronously

7. Emits a single summary record describing what was scheduled (and what was skipped)

Each run produces coordination decisions, not playback data.

---

📐 How Actor A and Actor B work together

🧩 Roles at a glance

• Actor A – Video Playback Monitor Performs a single playback availability check and reports detailed results.

• Actor B – Video Playback Replay Scheduler Decides when and from where playback checks should be repeated.

---

🔄 End-to-end flow

┌───────────────────────────────┐
│   Actor A: Playback Monitor   │
│                               │
│  • Opens page in browser      │
│  • Attempts video playback    │
│  • Confirms time progression  │
│  • Classifies result          │
│  • Writes dataset record      │
└───────────────┬───────────────┘
                │
                │ Dataset (results)
                ▼
┌───────────────────────────────┐
│  Actor B: Replay Scheduler    │
│                               │
│  • Reads past results         │
│  • Applies cooldown rules     │
│  • Enforces daily limits      │
│  • Rotates countries          │
│  • Respects local time zones  │
│  • Schedules new checks       │
└───────────────┬───────────────┘
                │
                │ Actor.call (async)
                ▼
┌───────────────────────────────┐
│   Actor A: Playback Monitor   │
│   (next scheduled run)        │
└───────────────────────────────┘

---

🧠 Why this separation matters

• Clear responsibility boundaries
• Predictable costs
• Easier debugging and auditing
• Better scalability over time

---

📊 Output: simple and transparent

Each run produces one summary dataset record, including:

• number of playback checks scheduled
• number of sessions skipped
• whether daily limits were reached
• completion timestamp

This Actor does not emit playback verification results.

---

💸 Cost & performance

• No browser automation
• No proxies
• Minimal memory and compute usage
• Fast startup and clean exit

By enforcing limits and cooldowns, this Actor helps reduce unnecessary playback checks and overall monitoring cost.

---

🚫 What this Actor does NOT do

• It does not load or play videos
• It does not bypass login, consent, or DRM restrictions
• It does not simulate user behavior
• It does not generate traffic or engagement
• It does not replace a playback verification Actor

---

⚖️ Responsible usage

You are responsible for ensuring that scheduled playback verification runs comply with applicable website terms and policies.

This Actor enforces responsible usage by design.

---

⭐ Summary

Video Playback Replay Scheduler answers a simple but critical question:

“When should we run playback checks again — without wasting resources?”

Used together with a playback verification Actor, it enables reliable, scalable, and cost-controlled monitoring workflows.

---

✅ Design highlights

• Orchestration-only
• Time-zone aware scheduling
• Built-in budget and rate limits
• Clean separation from playback logic
• Safe companion to paid playback Actors