Protocol

GKVoiceChatClient

The GKVoiceChatClient protocol is implemented to control the behavior of the GKVoiceChatService object. The voice chat client has a number of responsibilities:

Declaration

@protocol GKVoiceChatClient

Overview

  • Provides a network connection that the voice chat service uses to send and receive configuration data with other participants. If this network connection is shared with other application data, the client must also disambiguate between chat configuration data and application data.

  • Provides a participant ID that identifies the user to remote participants in the chat.

  • Defines how a remote user’s participant ID translates into a network connection to that user.

  • Accepts or rejects requests from remote participants to join the voice chat.

Topics

Getting Information about the Participant

- participantID

Returns a string that uniquely identifies the local user.

Required.

Sending data to other participants

- voiceChatService:sendData:toParticipantID:

A request for the client to send data to a participant.

Required.

- voiceChatService:sendRealTimeData:toParticipantID:

Asks the client to send data to a participant that must get there quickly.

Accepting Invitations from Remote Participants

- voiceChatService:didReceiveInvitationFromParticipantID:callID:

Asks the client to accept or reject an invitation from a remote participant.

Responding to Changes in Other Participants

- voiceChatService:didStartWithParticipantID:

Received by the client when a voice chat with another participant is established.

- voiceChatService:didNotStartWithParticipantID:error:

Received by the client when an attempt to establish a voice chat with another participant failed.

- voiceChatService:didStopWithParticipantID:error:

Received by the client when a previously established voice chat has ended.

Relationships

Inherits From

See Also

Voice Chat

GKVoiceChatService

The GKVoiceChatService class allows your application to connect two iOS devices into a voice chat.

Deprecated

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software