SmartphoneDeployment class
Contains the entire description and configuration for a study deployment on a smartphone.
- Inheritance
-
- Object
- PrimaryDeviceDeployment
- SmartphoneDeployment
- Mixed-in types
- Annotations
-
- @JsonSerializable(includeIfNull: false, explicitToJson: true)
Constructors
-
SmartphoneDeployment({String? studyId, String? studyDeploymentId, required PrimaryDeviceConfiguration<
DeviceRegistration> deviceConfiguration, required DeviceRegistration registration, Set<DeviceConfiguration< connectedDevices = const {}, Map<DeviceRegistration> >String, DeviceRegistration?> connectedDeviceRegistrations = const {}, Set<TaskConfiguration> tasks = const {}, Map<String, TriggerConfiguration> triggers = const {}, Set<TaskControl> taskControls = const {}, Set<ExpectedParticipantData> expectedParticipantData = const {}, String? participantId, String? participantRoleName, StudyDescription? studyDescription, DataEndPoint? dataEndPoint, String? privacySchemaName}) - Create a new SmartphoneDeployment.
-
SmartphoneDeployment.fromJson(Map<
String, dynamic> json) -
factory
- SmartphoneDeployment.fromPrimaryDeviceDeployment({String? studyId, String? studyDeploymentId, String? participantId, String? participantRoleName, required PrimaryDeviceDeployment deployment})
-
Create a SmartphoneDeployment based on a
PrimaryDeviceDeployment
. - SmartphoneDeployment.fromPrimaryDeviceDeploymentAndSmartphoneStudyProtocol({String? studyId, String? studyDeploymentId, String? participantId, String? participantRoleName, required PrimaryDeviceDeployment deployment, required SmartphoneStudyProtocol protocol})
-
Create a SmartphoneDeployment that combines a
PrimaryDeviceDeployment
and a SmartphoneStudyProtocol. - SmartphoneDeployment.fromSmartphoneStudyProtocol({String? studyId, String? studyDeploymentId, String? participantId, String? participantRoleName, required String primaryDeviceRoleName, required SmartphoneStudyProtocol protocol})
-
Create a SmartphoneDeployment based on a SmartphoneStudyProtocol.
This method basically makes a 1:1 mapping from the
protocol
to the deployment using aSmartphone
as the primary device with the specifiedprimaryDeviceRoleName
.
Properties
-
applicationData
↔ Map<
String, dynamic> ? -
getter/setter pairinherited
-
connectedDeviceRegistrations
↔ Map<
String, DeviceRegistration?> -
Preregistration of connected devices, including information such as
connection properties, stored per role name.
getter/setter pairinherited
-
connectedDevices
↔ Set<
DeviceConfiguration< DeviceRegistration> > -
The devices this device needs to connect to.
getter/setter pairinherited
- dataEndPoint ↔ DataEndPoint?
-
Specifies where and how to stored or upload the data collected from this
deployment. If
null
, the sensed data is not stored, but may still be used in the app.getter/setter pairinherited - deployed ↔ DateTime?
-
The timestamp (in UTC) when this deployment was deployed on this smartphone.
Is
null
if not deployed yet.getter/setter pair - description → String
-
no setterinherited
-
deviceConfiguration
↔ PrimaryDeviceConfiguration<
DeviceRegistration> -
The configuration for the primary device this deployment is intended for.
getter/setter pairinherited
- deviceRoleName → String?
-
The role name of this smartphone device.
no setter
-
devices
→ Set<
DeviceConfiguration< DeviceRegistration> > -
All devices this deployment is using.
no setter
-
expectedDataStreams
→ Set<
ExpectedDataStream> -
The set of expected data streams from this device deployment.
no setterinherited
-
expectedParticipantData
↔ Set<
ExpectedParticipantData> -
Expected data about participants in the deployment to be input by users.
getter/setter pairinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- lastUpdatedOn → DateTime
-
The time when this device deployment was last updated.
This corresponds to the most recent device registration as part of this
device deployment.
no setterinherited
-
measures
→ List<
Measure> -
Get the list of all measures in this study deployment.
no setter
- participantId ↔ String?
-
The ID of the participant in this deployment.
getter/setter pair
- participantRoleName ↔ String?
-
The role name of the participant in this deployment.
getter/setter pair
- privacySchemaName ↔ String?
-
The name of a PrivacySchema to be used for protecting sensitive data.
getter/setter pairinherited
- registration ↔ DeviceRegistration
-
Registration for this primary device.
getter/setter pairinherited
- responsible → StudyResponsible?
-
The PI responsible for this protocol.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- status ↔ StudyStatus
-
The unique id of the user that this deployment collects data from.
getter/setter pair
- studyDeploymentId → String
-
The unique id of this study deployment.
no setter
- studyDescription ↔ StudyDescription?
-
The description of this study protocol containing the title, description,
purpose, and the responsible researcher for this study.
getter/setter pairinherited
- studyId ↔ String?
-
The unique id of the study that this deployment is part of.
Is
null
if this is a local deployment running only on this phone.getter/setter pair -
taskControls
↔ Set<
TaskControl> -
The specification of tasks triggered and the devices they are sent to.
getter/setter pairinherited
-
tasks
↔ Set<
TaskConfiguration> -
All tasks which should be able to be executed on this or connected devices.
getter/setter pairinherited
-
triggers
↔ Map<
String, TriggerConfiguration> -
All triggers originating from this device and connected devices, stored
per assigned id unique within the study protocol.
getter/setter pairinherited
Methods
-
addApplicationData(
String key, dynamic value) → void -
inherited
-
getApplicationData(
String key) → dynamic -
inherited
-
getDeviceFromRoleName(
String roleName) → DeviceConfiguration< DeviceRegistration> ? -
Get the
DeviceConfiguration
based on theroleName
. This includes both the primary device and the connected devices. Returns null if no device withroleName
is found. -
getTaskByName(
String name) → TaskConfiguration? -
Get the task based on its task name in this deployment.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
removeApplicationData(
String key) → void -
inherited
-
toJson(
) → Map< String, dynamic> -
override
-
toString(
) → String -
A string representation of this object.
override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited