TTetheringProfile = class(TComponent)
class PASCALIMPLEMENTATION DECLSPEC_DRTTI TTetheringProfile : public System::Classes::TComponent
Base class for app tethering profiles.
A profile defines which data your application shares with the profiles of remote applications, and handles the data that those remote profiles share.
A profile is associated with a manager. Managers handle the process of discovering and pairing with remote applications and discovering remote profiles published by those applications. Managers also provide your profile with data to establish a connection to remote profiles, so that your profile can exchange data with remote profiles using a protocol and an adapter.
These are the main features of a profile:
- A profile can connect to a remote profile previously discovered by the manager of your profile, and it can allow or deny incoming connection requests.
- A profile can use send or receive commands from a connected profile. You can also use SendCommandWithResponse to send a command and receive a response command synchronously.
- A profile can use its manager to send a notification to a connected remote profile, and handle incoming notifications from connected remote profiles.
- You can temporarily disable (Enabled is
False) your profile to stop any communication to other profiles. You can also make your profile invisible (Visible is
False) so that the manager of your profile does not announce your profile to remote profiles.
- Use the Text property to describe your profile to remote profiles.
- You can add the profiles of two different applications to the same Group so that you can automatically connect both profiles to each other.
- Note: Subclasses of TTetheringProfile, such as TTetheringAppProfile, may provide additional features.
To use app tethering in your application you need a TTetheringProfile component. It is possible to have more than one TTetheringProfile component in the same application, but you only need one TTetheringProfile component.
- Note: There is no limit to the number of TTetheringProfile components that an application can have, but specific implementations of protocols, such as TTetheringTCPProtocol, may have limits that affect the number of TTetheringProfile components that your applications can use.