17c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Copyright 2012 Google Inc. All Rights Reserved. 27c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// 37c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Licensed under the Apache License, Version 2.0 (the "License"); 47c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// you may not use this file except in compliance with the License. 57c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// You may obtain a copy of the License at 67c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// 77c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// http://www.apache.org/licenses/LICENSE-2.0 87c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// 97c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Unless required by applicable law or agreed to in writing, software 107c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// distributed under the License is distributed on an "AS IS" BASIS, 117c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 127c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// See the License for the specific language governing permissions and 137c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// limitations under the License. 147c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 157c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#ifndef POLO_PAIRING_PAIRINGLISTENER_H_ 167c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#define POLO_PAIRING_PAIRINGLISTENER_H_ 177c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 187c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include <string> 197c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include "polo/pairing/polochallengeresponse.h" 207c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include "polo/pairing/poloerror.h" 217c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 227c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetnamespace polo { 237c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetnamespace pairing { 247c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 257c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetclass PairingSession; 267c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 277c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Listener for a pairing session. 287c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetclass PairingListener { 297c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet public: 307c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual ~PairingListener() {} 317c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 327c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked when a pairing session has been created. 337c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnSessionCreated() = 0; 347c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 357c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked when a pairing session has ended. 367c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnSessionEnded() = 0; 377c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 387c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked when the output device role should be performed. The client should 397c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // display a decoded secret based on the given gamma value. 407c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnPerformOutputDeviceRole(const Gamma& gamma) = 0; 417c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 427c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked when the input device role should be performed. The client should 437c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // prompt the user to enter the secret displayed on the output device. 447c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnPerformInputDeviceRole() = 0; 457c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 467c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked when pairing has completed successfully. 477c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnPairingSuccess() = 0; 487c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 497c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked when the pairing operation has been cancelled. 507c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnPairingCancelled() = 0; 517c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 527c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Invoked if there was an error during the pairing process. 537c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void OnError(PoloError error) = 0; 547c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet}; 557c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 567c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet} // namespace pairing 577c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet} // namespace polo 587c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 597c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#endif // POLO_PAIRING_PAIRINGLISTENER_H_ 60