收音机-Documentation-XCode.doc

RadioStreamCreated: 08/02/2012By: Goran VuksicContact:Web:IntroductionRadioStream is full native application for iPad and iPhone. This application stream internet radio music.Package contains two projects: one for iPad and one for iPhone, so you can release HD version for iPad and regular version for iPhone. iPhone version also includes Retina support (4G & 4S high resolution graphics).Easy to set up: just fill property list (XML) file with links of sreaming radio sites.Links to radio sites can be found here: and on many other online radio sitesRadio stream features:- easy to configure (no need to know programming in XCode)- group your stations in categories (rock, pop, electronic, hip-hop.)- prepulated XML with 40 radio streams divided in categories- 30 custom made station images- easy to add your own images for each station- application automaticaly remebers recent played stations- option to add station to favorites- play and pause music- settings: clear favorites and recents- application display HUD when buffering- graphics are made separate for each project to support different iPad and iPhone resolutions- iPhone 4G & 4S Retina support- and much more.Application is ready for build and upload to iTunes store.Thanks for purchase!Application descriptionRadio stream application allows user to listen defined radio station by streaming music from Internet. Stations are devided in categories, each category can hold unlimited number of station. User have options to add stations to favorites, to remove it from favorites, to check recently played stations and to clear both station lists: favorites and recents.Each application have Icon and Default (loading) image.RadioStream have tab navigation and it consist of 4 tabs:- Categories- Recents- Favorites- SettingsCategories are defined in property list (XML). Each category will appear in tab Categories as one row in table view, cell text is predefined category name that application reads from property list. Default categories, that you can easily change, are: rock, pop, electronic and hip-hop. For rows on this and all other views custom select view is defined, so when user select one row itll be highlighted with custom image. Beside this each cell have disclosure indicator enabled. Image below shows Categories tab on iPhone:When user select category, application will navigate to second screen where user can see all radio stations defined for this category. Difference between this view and category view is in cell background: cells on this view have speaker icon on left side. Screenshot on iPhone for this view is visible on image below:When user select station application will show player screen:For each station user can define image in property list that will be displayed in image placeholder on player screen. If image is not defined application will show default placeholder image. Each image is displayed in such way that there will be 10px spacing from each side on placeholder, so image will have gray border.Station is automaticaly streamed from Internet when view loads, while station is buffering HUD with message will be displayed.Below placeholder image there are 2 buttons: pause and add to favorites. Pause button will change to play button after user touch it and it will pause radio streaming. Add to favorites button will remeber that this station is favorited and user can play it again from favorites tab. Add to favorites will change to remove from favorites button after song is added to favorites.Default images for player view have green images for play and add to favorites buttons and blue images for pause and remove from favorites buttons:Recents tab show list of recently played radio stations, this view is visible on image below:Favorites tab display all favorited radio stations, those who user marked as favorite on player view. Favorites view is visible on image below:Settings screen allows user to clear all recent radio stations and all favorited radio stations. Settings view is visible on image below:When user taps row application will ask via alert dialog is user sure that all recents or favorites should be deleted:Projects for iPad and iPhone are same, with only one difference: iPad project dont have settings tab, so option to clear favorites is on right side of navigation bar in favorites tab: and option to clear recent files is also on right side of navigation bar in recents tab:All assets for iPad are created separately to fit in iPad 768*1024px resolution, iPad application preview is on image below (player view on iPad):Property list (XML) configurationProject is easy to configure with property list (XML) without any need to know programming. This file is named categorizedSites.plist can be found in folder Supporting Files. Structure of property list is shown on image below: For each category on categories view create ItemX where X stand for order number (keep in mind numbers start from zero). This item should be dictionary type and under it create string item categoryName which is name you want to define for each category.For each station you would like to add in this category add child node and name it SiteX (where X is number starting from 0).Station is defined with 3 child nodes:- siteName: name of radio station- siteLink: URL to streaming radio web site- siteLogoName: name of .png image added to project that will be displayed in image placeholder on player viewXCode project overviewProject requires following frameworks:- Foundation.framework- UIKit.framework- CoreGraphics.framework- MediaPlayer.frameworkIn project supporting files youll find MBProgressHUD class, that is helper class from creating HUD. HUD is shown on player view when buffering stream.XCode classesAppDelegateApplication delegate in method:- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptionscreates UITabBarController with views for each of 4 tabs: categories, recents, favorites and settings.CategoryViewControllerCategory view display list of categories from property list. Property list name is defined at top of main file:#define kPlistName categorizedSitesThis view is table view, on row select method:- (void)tableView:(UITableView*)tableView didSelectRowAtIndexPath:(NSIndexPath*)indexPathwill open SitesViewController.SitesViewControllerThis view controller show list of radio stations in each category in table view, on row select PlayerViewController is allocated.PlayerViewControllerPlayer view controller is used to streaming audio from link in property list. Buttons in Interface Builder are connected with following methods that are used to play/pause music and to add/remove item to favorites:- (IBAction)addOrRemoveFromFavoritesButtonPressed- (IBAction)playOrPauseButtonPressedRecentViewControllerRecent tab use this view controller. List of recent radio stations is stored in property list that is created on iOS device. Name of this property list can be defined on top of main class:#define kRecentsPlistName recentSitesMethod:- (void)tableView:(UITableView*)tableView didSelectRowAtIndexPath:(NSIndexPath*)indexPathwill open PlayerViewController to play selected recent item.FavoritesViewControllerFavorites view is defined