AmbientStatus 0.1.0

AmbientStatus 0.1.0

×

TestsTested ✗
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2014

Maintained by ruddfawcett.

AmbientStatus 0.1.0

  • By
  • Rudd Fawcett

Seamlesssly update your app based on the ambiance of your users. Inspired by "Path Talk - The New Messenger," AmbientStatus offers all of the same "Ambient Status" features, with more to come.

From Path's "Path Talk - The New Messenger" Description:

Ambient Status: Path talk can automatically tell your friends when you're in transit, in the neighborhood, or even low on battery so your availability is always understood — removing the headache of misunderstandings in conversation.

AmbientStatus provides delegates and properties for all of the features in the description above:

  • Transit Monitor ASTransitMonitor
    • Whether the user is in transit, and the type of transit (Stationary, Walking, Running or Driving), and notifications of any change.
  • Battery Monitor ASBatteryMonitor
    • Provides battery percentage and state (Unknown, Unplugged, Charging or Full) for up to date battery level, and notifications of any change.
  • Location Monitor ASLocationMonitor (Untested)
    • Detects if the user has entered within a kMaximumRadius of a location (CLLocation), and provides feedback upon leaving the area.

AmbientStatus was planned to have a single header file - AmbientStatus.h - that was going to conditionally include headers based on subspecs installed. This is not working. See issue #1 if you have any thoughts, please!

Podfile, Full AmbientStatus

platform :ios, '7.0'
pod "AmbientStatus", "~> 0.1.0"

Podfile, Individual Monitors:

platform :ios, '7.0'
pod "AmbientStatus/ASTransitMonitor"
pod "AmbientStatus/ASBatteryMonitor"
pods "AmbientStatus/ASLocationMonitor"

Trying it Out

Trying the Demo

If you are just looking to try the demo project, run the following in Terminal:

$ gem install cocoapods-try && pod try AmbientStatus

Trying Demo (without pod try)

$ git clone https://github.com/AmbientStatus/AmbientStatus
$ cd AmbientStatus/Example && pod install

Usage

Find updated usage guidelines at each pod's individual repo:

Credits

ASTransitMonitor takes much of the code (though not verbatim) from SOMotionDetector with permission, which was developed by Artur Mkrtchyan (arturdev) for SocialObjects Software.

The rest of the project was developed by Rudd Fawcett. You can find all of his open source projects on GitHub.

Questions?

Open an issue. I'll try get back to you within 24 hours.

License

AmbientStatus is available under the MIT license. See the LICENSE file for more info.