summaryrefslogtreecommitdiff
path: root/SmartDeviceLink-iOS/SmartDeviceLink/SDLSetGlobalProperties.h
blob: 7ad36e8d5d1b54710a175cd7f2ad365ca800b8fa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
//  SDLSetGlobalProperties.h
//

#import "SDLRPCRequest.h"

@class SDLImage;
@class SDLKeyboardProperties;


/**
 * Sets value(s) for the specified global property(ies)
 * <p>
 * Function Group: Base <p>
 * <b>HMILevel needs to be FULL, LIMITED or BACKGROUND</b>
 * </p>
 *
 * Since SmartDeviceLink 1.0
 * See SDLResetGlobalProperties
 */
@interface SDLSetGlobalProperties : SDLRPCRequest {
}

/**
 * @abstract Constructs a new SDLSetGlobalProperties object
 */
- (instancetype)init;
/**
 * @abstract Constructs a new SDLSetGlobalProperties object indicated by the NSMutableDictionary
 * parameter
 * @param dict The dictionary to use
 */
- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

/**
 * @abstract Sets a Vector<TTSChunk> for Help Prompt that Array of one or more
 * TTSChunk elements specifying the help prompt used in an interaction
 * started by PTT
 * @discussion helpPrompt
 *            a Vector<TTSChunk> of one or more TTSChunk elements
 *            <p>
 *            <b>Notes: </b>
 *            <ul>
 *            <li>Array must have at least one element</li>
 *            <li>Only optional it timeoutPrompt has been specified</li>
 *            </ul>
 */
@property (strong) NSMutableArray *helpPrompt;
/**
 * @abstract A Vector<TTSChunk> for Timeout Prompt representing Array of one or
 * more TTSChunk elements specifying the help prompt used in an interaction
 * started by PTT
 *
 */
@property (strong) NSMutableArray *timeoutPrompt;
/**
 * @abstract Sets a voice recognition Help Title
 *
 * @discussion A String value representing a voice recognition Help Title
 *            <p>
 *            <b>Notes: </b><br/>
 *            <ul>
 *            <li>If omitted on supported displays, the default SDL help
 *            title will be used</li>
 *            <li>If omitted and one or more vrHelp items are provided, the
 *            request will be rejected.</li>
 *            <li>String Maxlength = 500</li>
 *            </ul>
 * @since SmartDeviceLink 2.0
 */
@property (strong) NSString *vrHelpTitle;
/**
 * @abstract Sets the items listed in the VR help screen used in an interaction
 * started by PTT
 *
 * @discussion A Vector value representing items listed in the VR help screen
 *            used in an interaction started by PTT
 *            <p>
 *            <b>Notes: </b><br/>
 *            <ul>
 *            <li>If omitted on supported displays, the default SmartDeviceLink VR
 *            help / What Can I Say? screen will be used</li>
 *            <li>If the list of VR Help Items contains nonsequential
 *            positions (e.g. [1,2,4]), the RPC will be rejected</li>
 *            <li>If omitted and a vrHelpTitle is provided, the request
 *            will be rejected</li>
 *            <li>Array Minsize: = 1</li>
 *            <li>Array Maxsize = 100</li>
 *            </ul>
 * @since SmartDeviceLink 2.0
 */
@property (strong) NSMutableArray *vrHelp;
@property (strong) NSString *menuTitle;
@property (strong) SDLImage *menuIcon;
@property (strong) SDLKeyboardProperties *keyboardProperties;

@end