proxybuy-flutter/HUNT_DEMO_SCRIPT.md

5.1 KiB

Hunt Feature Demo Script

Setup Instructions

  1. Build and Install the App:

    cd d:\LBA\lba
    flutter build apk --debug
    flutter install
    
  2. Navigate to Hunt Section:

    • Open the app
    • Tap on the "Hunt" tab in the bottom navigation

Demo Walkthrough

Part 1: Card Selection (00:00 - 01:30)

  1. Show the main Hunt screen:

    • Point out the "Treasure Hunt" title
    • Highlight the user's current points and rank
    • Read the instructions box
  2. Explore the Hunt Cards:

    • Scroll through the 5 available cards
    • Show different point values (200, 180, 150, 120, 100)
    • Highlight different categories (Restaurant, Electronics, Coffee Shop, etc.)
    • Point out the category icons and point indicators
  3. Select a Hunt Card:

    • Tap on the highest point card (Restaurant - 200 points)
    • Show the card flip animation
    • Read the mystery question aloud
    • Point out the 12-hour timer

Part 2: Hunt Activation (01:30 - 03:00)

  1. Start the Hunt:

    • Tap "Start Hunt" in the dialog
    • Allow location permissions when prompted
    • Show the active hunt interface
  2. Explain the Interface:

    • Point out the countdown timer at the top
    • Show the selected card with the mystery question
    • Explain the two action buttons: "Get Hint" and "Leaderboard"
  3. Check Hunt Status:

    • Scroll down to show the Hunt Status section
    • Point out Location Access, Camera Access, and Time Remaining

Part 3: Hint System (03:00 - 04:30)

  1. Access the Hint Feature:

    • Tap "Get Hint" button
    • Allow camera permissions when prompted
    • Show the AR camera interface
  2. Demonstrate AR Scanner:

    • Point out the scanning animations
    • Show the corner brackets and scanning circle
    • Explain that you need to be near the target location (100m range)
    • Show the instructions at the bottom
  3. Exit Hint Mode:

    • Tap the close button to return to hunt

Part 4: Leaderboard (04:30 - 05:30)

  1. Open Leaderboard:

    • Tap "Leaderboard" button
    • Show the slide-up animation
    • Point out the different ranks and point totals
  2. Highlight Features:

    • Show the user's highlighted position
    • Point out the trophy icons for top 3
    • Show the different rank colors (Gold, Silver, Bronze)
    • Demonstrate the close handle and close button

Part 5: Hunt Completion Simulation (05:30 - 07:00)

  1. Simulate Hunt Success:

    • For demo purposes, manually trigger completion
    • Show the success animation and sound effects
    • Display the congratulations dialog
  2. Points Award:

    • Show the points being added (+200 points)
    • Demonstrate the "View Leaderboard" option
    • Show how the user's rank changes in the leaderboard
  3. Reset for New Hunt:

    • Tap "Play Again"
    • Return to card selection screen
    • Show how points are maintained

Key Features to Emphasize

Visual Design

  • Professional UI: Modern card-based design
  • Smooth Animations: Card flips, scale effects, slide transitions
  • Dark/Light Mode: Works perfectly in both themes
  • Responsive Layout: Adapts to different screen sizes

Gamification Elements

  • Point System: Different cards offer different rewards
  • Time Pressure: 12-hour countdown creates urgency
  • Competition: Real-time leaderboard with rankings
  • Achievement: Celebration effects on completion

Technical Excellence

  • Location Integration: Real GPS monitoring
  • AR Capabilities: Camera-based hint system
  • Permission Handling: Smooth user experience
  • State Management: Proper data flow and updates

User Experience

  • Intuitive Interface: Clear instructions and visual cues
  • Progressive Disclosure: Information revealed step by step
  • Accessibility: Good contrast and readable text
  • Feedback: Audio, visual, and haptic responses

Demo Tips

  1. Prepare the Environment:

    • Ensure good lighting for camera demo
    • Have location services enabled
    • Test on a physical device (not emulator)
  2. Narrative Flow:

    • Start with the problem: "How do we make exploring the city more engaging?"
    • Show the solution: "Gamified treasure hunts with AR hints"
    • Demonstrate value: "Social competition with real rewards"
  3. Technical Highlights:

    • Mention real-time location monitoring
    • Emphasize the AR scanning technology
    • Point out the professional animation work
    • Show the responsive design switching themes
  4. Future Potential:

    • Explain how this connects to real businesses
    • Mention potential for partnerships with local stores
    • Discuss scalability for different cities
    • Show integration possibilities with existing features

Troubleshooting

  • Camera not working: Check permissions in device settings
  • Location not detected: Ensure GPS is enabled and app has permission
  • Cards not loading: Wait for animation to complete
  • Timer not starting: Verify location permission is granted

Mock Data Locations

All hunt cards currently point to: 32.62501010252744, 51.72622026956878 This allows for easy testing without actually traveling to multiple locations.