Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы GameKit ссылка на протокол GKVoiceChatClient

Опции
Развертывание Target:

На этой странице
Язык:

GKVoiceChatClient

Наследование

Не применимый

Соответствует

Оператор импорта

Swift

import GameKit

Objective C

@import GameKit;

Доступность

Доступный в iOS 3.0 и позже.

GKVoiceChatClient протокол реализован для управления поведением GKVoiceChatService объект. У клиента голосового чата есть много ответственности:

  • Обеспечивает сетевое соединение что использование службы голосового чата, чтобы отправить и получить данные конфигурации с другими участниками. Если это сетевое соединение совместно используется с другими данными приложения, клиент должен также снять неоднозначность между данными конфигурации чата и данными приложения.

  • Обеспечивает участвующий ID, идентифицирующий пользователя для удаленных участников чата.

  • Определяет, как участвующий ID удаленного пользователя переводит в сетевое соединение с тем пользователем.

  • Принимает или отклоняет запросы от удаленных участников для присоединения к голосовому чату.

Получение информации об участнике
  • participantID () - participantID Требуемый

    Возвращает строку, однозначно определяющую локального пользователя. (требуемый)

    Объявление

    Swift

    func participantID() -> String!

    Objective C

    - (NSString *)participantID

    Возвращаемое значение

    Строка, которая может использоваться другими участниками для соединения с локальным пользователем.

    Обсуждение

    Клиент решает формат и значение участвующего идентификатора. Для получения дополнительной информации см. Игровое Руководство по программированию Центра.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.

Отправка данных другим участникам
  • voiceChatService (_: sendData:toParticipantID:) - voiceChatService:sendData:toParticipantID: Требуемый

    Запрос на клиент, чтобы отправить данные участнику. (требуемый)

    Объявление

    Swift

    func voiceChatService(_ voiceChatService: GKVoiceChatService!, sendData data: NSData!, toParticipantID participantID: String!)

    Objective C

    - (void)voiceChatService:(GKVoiceChatService *)voiceChatService sendData:(NSData *)data toParticipantID:(NSString *)participantID

    Параметры

    voiceChatService

    Служба, запросившая передачу.

    data

    Данные для отправки.

    participantID

    Строка, однозначно определяющая участника для отправки данных в.

    Обсуждение

    Реализация этого метода должна надежно передать данные участнику, идентифицированному participantID. Когда клиент на другом конце получает данные, он должен передать его службе голосового чата путем вызова службы receivedData:fromParticipantID: метод.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.

  • voiceChatService (_: sendRealTimeData:toParticipantID:) - voiceChatService:sendRealTimeData:toParticipantID:

    Просит клиент отправлять данные участнику, который должен добраться там быстро.

    Объявление

    Swift

    optional func voiceChatService(_ voiceChatService: GKVoiceChatService!, sendRealTimeData data: NSData!, toParticipantID participantID: String!)

    Objective C

    - (void)voiceChatService:(GKVoiceChatService *)voiceChatService sendRealTimeData:(NSData *)data toParticipantID:(NSString *)participantID

    Параметры

    voiceChatService

    Служба, запросившая передачу.

    data

    Данные для отправки.

    participantID

    Строка, однозначно определяющая участника для отправки данных в.

    Обсуждение

    Реализация этого метода отображается participantID представьте в виде строки известному участнику и передачам данные им. Данные, переданные этим методом, могут быть отправлены ненадежно. Когда клиент на другом конце получает эти данные, он должен передать его службе голосового чата путем вызова службы receivedRealTimeData:fromParticipantID: метод.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.

Принятие приглашений от удаленных участников
  • voiceChatService (_: didReceiveInvitationFromParticipantID:callID:) - voiceChatService:didReceiveInvitationFromParticipantID:callID:

    Просит клиент принимать или отклонять приглашение от удаленного участника.

    Объявление

    Swift

    optional func voiceChatService(_ voiceChatService: GKVoiceChatService!, didReceiveInvitationFromParticipantID participantID: String!, callID callID: Int)

    Objective C

    - (void)voiceChatService:(GKVoiceChatService *)voiceChatService didReceiveInvitationFromParticipantID:(NSString *)participantID callID:(NSInteger)callID

    Параметры

    voiceChatService

    Служба, получившая запрос.

    participantID

    Строка, однозначно определяющая другого пользователя.

    callID

    Целое число, однозначно определяющее запрос.

    Обсуждение

    Если этот метод не реализован клиентом, служба голосового чата автоматически принимают запросы от других участников.

    Этот метод должен вызвать службу acceptCallID:error: метод, если это хочет принять запрос или denyCallID: отклонить его.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.

Реакция на изменения в других участниках
  • voiceChatService (_: didStartWithParticipantID:) - voiceChatService:didStartWithParticipantID:

    Полученный клиентом, когда установлен голосовой чат с другим участником.

    Объявление

    Swift

    optional func voiceChatService(_ voiceChatService: GKVoiceChatService!, didStartWithParticipantID participantID: String!)

    Objective C

    - (void)voiceChatService:(GKVoiceChatService *)voiceChatService didStartWithParticipantID:(NSString *)participantID

    Параметры

    voiceChatService

    Служба голосового чата, инициировавшая соединение.

    participantID

    Строка, однозначно определяющая другого пользователя.

    Обсуждение

    Ваш клиент может использовать этот метод для обновления пользовательского интерфейса, чтобы показать, что было установлено соединение.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.

  • voiceChatService (_: didNotStartWithParticipantID:error:) - voiceChatService:didNotStartWithParticipantID:error:

    Полученный клиентом, когда попытка установить голосовой чат с другим участником перестала работать.

    Объявление

    Swift

    optional func voiceChatService(_ voiceChatService: GKVoiceChatService!, didNotStartWithParticipantID participantID: String!, error error: NSError!)

    Objective C

    - (void)voiceChatService:(GKVoiceChatService *)voiceChatService didNotStartWithParticipantID:(NSString *)participantID error:(NSError *)error

    Параметры

    voiceChatService

    Служба голосового чата, устанавливавшая соединение.

    participantID

    Строка, однозначно определяющая другого пользователя.

    error

    Ошибка, препятствовавшая тому, чтобы был установлен голосовой чат.

    Обсуждение

    Ваше приложение может реализовать этот метод, чтобы уведомить пользователя, что ошибка произошла при установлении соединения.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.

  • voiceChatService (_: didStopWithParticipantID:error:) - voiceChatService:didStopWithParticipantID:error:

    Полученный клиентом, когда закончился ранее установленный голосовой чат.

    Объявление

    Swift

    optional func voiceChatService(_ voiceChatService: GKVoiceChatService!, didStopWithParticipantID participantID: String!, error error: NSError!)

    Objective C

    - (void)voiceChatService:(GKVoiceChatService *)voiceChatService didStopWithParticipantID:(NSString *)participantID error:(NSError *)error

    Параметры

    voiceChatService

    Голосовой чат, поддержавший соединение.

    participantID

    Строка, однозначно определяющая разъединившегося пользователя.

    error

    Ошибка, заставившая чат заканчиваться.

    Обсуждение

    Ваше приложение может реализовать этот метод, чтобы уведомить пользователя, что закончилось установленное речевое соединение. Это может произойти, когда другой участник заканчивает чат или если было потеряно сетевое соединение.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 3.0 и позже.