Retrieves and parses an Xbox Live Gamercard for a player, providing a hash of the relevant data about the player or the raw HTML.
Add this line to your application's Gemfile:
gem 'gamercard'
And then execute:
$ bundle
Or install it yourself as:
$ gem install gamercard
Returns a hash suitable for JSON serialization.
resp = Gamercard.get('laikal1')
pp resp
# =>
{"gamertag"=>"laikal1",
"link"=>"http://live.xbox.com/en-US/Profile?Gamertag=laikal1",
"gamerpic"=>"http://avatar.xboxlive.com/avatar/laikal1/avatarpic-l.png",
"gamerscore"=>49646,
"location"=>"Ann Arbor, MI",
"motto"=>"Complexify!",
"name"=>"Nyarlathotep (1 bucket)",
"bio"=>"Design is how it works.",
"reputation"=>4.25,
"recent_games"=>
[{"comparison_url"=>
"http://live.xbox.com/en-US/Activity/Details?titleId=1161890110&compareTo=laikal1",
"image"=>
"http://tiles.xbox.com/tiles/9a/SL/0mdsb2JhbA9ECgQNGwEfV1wmL2ljb24vMC84MDAwIAAAAAAAAP2kpOo=.jpg",
"title"=>"KoA: Reckoning",
"last_played"=>"3/29/2012",
"earned_gamerscore"=>10,
"available_gamerscore"=>1300,
"earned_achievements"=>1,
"available_achievements"=>61,
"percentage_complete"=>"1%"},
{"comparison_url"=>
"http://live.xbox.com/en-US/Activity/Details?titleId=1161890141&compareTo=laikal1",
"image"=>
"http://tiles.xbox.com/tiles/np/G2/12dsb2JhbA9ECgQNGwEfV1onL2ljb24vMC84MDAwIAAAAAAAAPiZkYE=.jpg",
"title"=>"Mass Effect 3",
"last_played"=>"3/28/2012",
"earned_gamerscore"=>1025,
"available_gamerscore"=>1050,
"earned_achievements"=>51,
"available_achievements"=>52,
"percentage_complete"=>"98%"},
{"comparison_url"=>
"http://live.xbox.com/en-US/Activity/Details?titleId=1161890083&compareTo=laikal1",
"image"=>
"http://tiles.xbox.com/tiles/WQ/nz/0Wdsb2JhbA9ECgQNGwEfV11QL2ljb24vMC84MDAwIAAAAAAAAP7cCUY=.jpg",
"title"=>"Syndicate",
"last_played"=>"3/11/2012",
"earned_gamerscore"=>530,
"available_gamerscore"=>1000,
"earned_achievements"=>33,
"available_achievements"=>50,
"percentage_complete"=>"66%"},
{"comparison_url"=>
"http://live.xbox.com/en-US/Activity/Details?titleId=1414793176&compareTo=laikal1",
"image"=>
"http://tiles.xbox.com/tiles/fc/qf/0Wdsb2JhbA9ECgUMGgQfWStbL2ljb24vMC84MDAwIAAAAAAAAP6wymI=.jpg",
"title"=>"BioShock",
"last_played"=>"2/25/2012",
"earned_gamerscore"=>1100,
"available_gamerscore"=>1100,
"earned_achievements"=>51,
"available_achievements"=>51,
"percentage_complete"=>"100%"},
{"comparison_url"=>
"http://live.xbox.com/en-US/Activity/Details?titleId=1112737766&compareTo=laikal1",
"image"=>
"http://tiles.xbox.com/tiles/qR/QI/1Gdsb2JhbA9ECgQKGgMfWSpVL2ljb24vMC84MDAwIAAAAAAAAPsnFLY=.jpg",
"title"=>"Skyrim",
"last_played"=>"2/14/2012",
"earned_gamerscore"=>910,
"available_gamerscore"=>1000,
"earned_achievements"=>47,
"available_achievements"=>50,
"percentage_complete"=>"94%"}]}Gamercard uses Faraday, so you can use any http backend that Faraday supports. It assumes Typhoeus by default. Tell Gamercard what http library you are using by:
Gamercard.adapter = :excon # (or :typhoeus, w/e)A block-style configurator is also available:
Gamercard.configure do |c|
c.adapter = :typhoeus
c.user_agent = "My Awesome Client"
end- v0.0.1 Hello World
- Returns all the basic gamercard data, sans status. Status can be had from a public site, though, so that is next!
This project builds on work done by the following people and projects:
- barisbalic's gamertag, which depends on unfortunately unreliable 3rd-party proxies to Microsoft's service. This gem provides less data, but scrapes it directly from http://live.xbox.com – Straight from the horse's mouth, if you will.
So: thanks a ton to him.
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright (c) 2011 Matt Wilson. See LICENSE for details.