155 lines
5.1 KiB
Markdown
155 lines
5.1 KiB
Markdown
# Hunt Feature Demo Script
|
|
|
|
## Setup Instructions
|
|
|
|
1. **Build and Install the App**:
|
|
```bash
|
|
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.
|