AudioGuidance

An iOS prototype that detects iBeacon proximity and fires repeating in-range events — the skeleton for location-aware audio guidance.

Features

• iBeacon region monitoring — registers a CLBeaconRegion and receives enter/exit callbacks via the BeaconMan wrapper around Core Location.
• Immediate-proximity event loop — listens for a beacon entering immediate range and repeats the trigger every 15 seconds, the hook intended to drive audio guidance playback.
• Core Data stack — AppDelegate ships the standard managed-object-context / persistent-store scaffolding (model is currently empty, ready to define entities).
• Storyboard UI — Main.storyboard plus a launch screen, single-ViewController entry point.

Note: this is an early-stage prototype. The enter/exit/immediate callback bodies and the Core Data model are intentionally empty stubs — the wiring for beacon detection is in place, but the audio playback itself is not yet implemented. kBeaconUUID is also blank and must be set to a real beacon UUID before the app can detect anything.

Usage

# 1. Install dependencies (CocoaPods)
pod install

# 2. Open the workspace (NOT the .xcodeproj — Pods are linked via the workspace)
open AudioGuidance.xcworkspace

# 3. Set your beacon UUID in AudioGuidance/ViewController.m
#    static NSString *const kBeaconUUID = @"<YOUR-BEACON-UUID>";

# 4. Build & run on a physical device (iBeacon ranging is unavailable in the Simulator)

Core Location requires a location-usage permission. Before shipping, add an NSLocationWhenInUseUsageDescription (or NSLocationAlwaysUsageDescription) key to Info.plist.

Project layout

AudioGuidance/
├── AudioGuidance/                      # App target sources
│   ├── AppDelegate.{h,m}               # App lifecycle + Core Data stack
│   ├── ViewController.{h,m}            # iBeacon region registration & immediate-proximity loop
│   ├── main.m                          # UIApplicationMain entry point
│   ├── Info.plist                      # App bundle configuration
│   ├── Assets.xcassets/                # App icon set
│   ├── Base.lproj/                     # Main.storyboard, LaunchScreen.storyboard
│   └── AudioGuidance.xcdatamodeld/     # Core Data model (currently empty)
├── AudioGuidanceTests/                 # Unit test target
├── AudioGuidanceUITests/               # UI test target
├── AudioGuidance.xcodeproj/            # Xcode project
├── AudioGuidance.xcworkspace/          # CocoaPods workspace (open this)
├── Podfile                             # CocoaPods dependencies (BeaconMan ~> 0.1.0)
└── Podfile.lock                        # Resolved pod versions

Tech stack

• Language: Objective-C
• Platform: iOS 9.3+ (built against the iOS 9.0 deployment platform in the Podfile)
• Frameworks: UIKit, Core Location (iBeacon ranging), Core Data
• Dependencies: BeaconMan ~> 0.1.0 via CocoaPods (use_frameworks!)
• Created: 2016 · Bundle ID com.zyxw.AudioGuidance

_{Migrated from Bitbucket. Commit history preserved as-is.}