WiTap

===========================================================================

DESCRIPTION:

The WiTap sample application demonstrates how to achieve network communication between applications. Using Bonjour, the application both advertises itself on the local network and displays a list of other instances of this application on the network.

Simply build the sample using Xcode and run it in the simulator or on the device. Wait for another player to connect or select a game to connect to. Once connected, tap one or more colored pads on a device to see them highlighted simultaneously on the remote device.

This version of WiTap works over Bluetooth again, courtesy of the NSNetService peer-to-peer support in iOS 7.  Indeed, it now works over peer-to-peer Wi-Fi as well.

Note: For more information about peer-to-peer support in NSNetService, see QA1753 "Bonjour over Bluetooth on iOS 5.0".

<https://developer.apple.com/library/ios/#qa/qa1753/_index.html>

===========================================================================

BUILD REQUIREMENTS:

OS X 10.9.3, Xcode 5.1.1, iOS 7.1 SDK

===========================================================================

RUNTIME REQUIREMENTS:

iOS 7.0 or later

===========================================================================

PACKING LIST:

ReadMe.txt

This document.

WiTap.xcodeproj

An Xcode project for the sample.

Info.plist

Icons

Default Images

Various boilerplate resources.

AppController.h

AppController.m

UIApplication's delegate class, the central controller of the application.

TapViewController.h

TapViewController.m

The main view controller for the app.

TapView.h

TapView.m

UIView subclass that can highlight itself when locally or remotely tapped.

PickerViewController.h

PickerViewController.m

A view controller that displays both the currently advertised game name and a list of other games available on the local network.

Main.storyboard

The main storyboard for the app.

cross24.png

cross24@2x.png

Images used by the above.

main.m

The main file for the WiTap application.

===========================================================================

CHANGES FROM PREVIOUS VERSIONS:

Version 2.1

- Re-enabled peer-to-peer operation courtesy of the includesPeerToPeer property added to NSNetService in iOS 7.

- Removed QServer in favor of the connection listening support added to NSNetService in iOS 7 (NSNetServiceListenForConnections).

- Updated to the latest coding techniques and standards (including storyboards, Auto Layout, 64-bit and modules).

Version 2.0

- A major rewrite.

- Updated to the latest coding techniques and standards.

- Adopted QServer to replace the ancient TCPServer.

- Changed the on-the-wire protocol to allow easy testing via telnet.

- Implement an 'end game' button to allow for easier testing.

- Support rotation in all view controllers.

- Fully adopted view controllers (the previous code came from a time when dinosaurs ruled the Earth and view controllers weren't de rigueur, and thus parts of the app used view controllers and parts didn't).

- Basic multitasking support.

- Keep the TCP server running to avoid port creep.

- Fixed down numerous sharp edge cases.

Version 1.8

- Upgraded project to build with the iOS 4.1 SDK

- Implemented an autorelease to the NSNetServiceBrowser object to release the browser once the connection is established. An active browser can cause a delay in sending packets - <rdar://problem/7000938>

- Upgraded for IPv6 as default, creates IPv4 socket is unable to create IPv6 socket.

- fixed logic bug in handleEvent to check for read method failure.

Version 1.7

- Fixed table selection and cell update bugs, and added support for handling stream errors.

Version 1.6

- Upgraded for 3.0 SDK due to deprecated APIs; in "cellForRowAtIndexPath" it now uses UITableViewCell's initWithStyle.

Version 1.5

- Updated for and tested with iPhone OS 2.0. First public release.

Version 1.4

- Updated for Beta 7.

- Code clean up.

- Improved Bonjour support.

Version 1.3

- Updated for Beta 4. 

- Added code signing.

Version 1.2

- Added icon.

Copyright (C) 2008-2014 Apple Inc. All rights reserved.