AmbientStatus

[Deprecated] Seamlessly update your app based on your user's ambiance.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

66

Maintenance

Last Commit

7yrs ago

Contributors

0

Package

Dependencies

0

License

MIT

Categories

Readme

AmbientStatus

CI Status Version License Platform

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!

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like AmbientStatus in your projects.

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.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial