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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
//
// SDLStreamingDataManager.h
// SmartDeviceLink-iOS
//
// Created by Joel Fischer on 8/11/15.
// Copyright (c) 2015 smartdevicelink. All rights reserved.
//
#import <Foundation/Foundation.h>
@import VideoToolbox;
#import "SDLProtocolListener.h"
@class SDLAbstractProtocol;
@class SDLDisplayCapabilities;
@class SDLTouchManager;
NS_ASSUME_NONNULL_BEGIN
typedef NS_ENUM(NSInteger, SDLStreamingVideoError) {
SDLStreamingVideoErrorHeadUnitNACK = 0,
SDLSTreamingVideoErrorInvalidOperatingSystemVersion __deprecated_enum_msg("Use SDLStreamingVideoErrorInvalidOperatingSystemVersion instead") = 1,
SDLStreamingVideoErrorInvalidOperatingSystemVersion = 1,
SDLStreamingVideoErrorConfigurationCompressionSessionCreationFailure = 2,
SDLStreamingVideoErrorConfigurationAllocationFailure = 3,
SDLStreamingVideoErrorConfigurationCompressionSessionSetPropertyFailure = 4
};
typedef NS_ENUM(NSInteger, SDLEncryptionFlag) {
SDLEncryptionFlagNone,
SDLEncryptionFlagAuthenticateOnly,
SDLEncryptionFlagAuthenticateAndEncrypt
};
typedef NS_ENUM(NSInteger, SDLStreamingAudioError) {
SDLStreamingAudioErrorHeadUnitNACK
};
extern NSString *const SDLErrorDomainStreamingMediaVideo;
extern NSString *const SDLErrorDomainStreamingMediaAudio;
typedef void (^SDLStreamingStartBlock)(BOOL success, NSError *__nullable error);
typedef void (^SDLStreamingEncryptionStartBlock)(BOOL success, BOOL encryption, NSError *__nullable error);
#pragma mark - Interface
@interface SDLStreamingMediaManager : NSObject <SDLProtocolListener>
@property (assign, nonatomic, readonly) BOOL videoSessionConnected;
@property (assign, nonatomic, readonly) BOOL audioSessionConnected;
@property (assign, nonatomic, readonly) BOOL videoSessionAuthenticated;
@property (assign, nonatomic, readonly) BOOL audioSessionAuthenticated;
/**
* Touch Manager responsible for providing touch event notifications.
*/
@property (nonatomic, strong, readonly) SDLTouchManager* touchManager;
/**
* The settings used in a VTCompressionSessionRef encoder. These will be verified when the video stream is started. Acceptable properties for this are located in VTCompressionProperties. If set to nil, the defaultVideoEncoderSettings will be used.
*
* @warning Video streaming must not be connected to update the encoder properties. If it is running, issue a stopVideoSession before updating.
*/
@property (strong, nonatomic, null_resettable) NSDictionary* videoEncoderSettings;
/**
* Provides default video encoder settings used.
*/
@property (strong, nonatomic, readonly) NSDictionary* defaultVideoEncoderSettings;
/**
* This is the current screen size of a connected display. This will be the size the video encoder uses to encode the raw image data.
*/
@property (assign, nonatomic, readonly) CGSize screenSize;
- (instancetype)initWithProtocol:(SDLAbstractProtocol *)protocol __deprecated_msg(("Please use initWithProtocol:displayCapabilities: instead"));
- (instancetype)initWithProtocol:(SDLAbstractProtocol *)protocol displayCapabilities:(SDLDisplayCapabilities*)displayCapabilities;
/**
* This method will attempt to start a streaming video session. It will set up iOS's video encoder, and call out to the head unit asking if it will start a video session.
*
* @warning If this method is called on an 8.0 device, it will assert (in debug), or return a failure immediately to your block (in release).
*
* @param startBlock A block that will be called with the result of attempting to start a video session
*/
- (void)startVideoSessionWithStartBlock:(SDLStreamingStartBlock)startBlock;
// TODO: Documentation
- (void)startVideoSessionWithTLS:(SDLEncryptionFlag)encryptionFlag startBlock:(SDLStreamingEncryptionStartBlock)startBlock;
/**
* This method will stop a running video session if there is one running.
*/
- (void)stopVideoSession;
/**
* This method receives raw image data and will run iOS8+'s hardware video encoder to turn the data into a video stream, which will then be passed to the connected head unit.
*
* @param imageBuffer A CVImageBufferRef to be encoded by Video Toolbox
*
* @return Whether or not the data was successfully encoded and sent.
*/
- (BOOL)sendVideoData:(CVImageBufferRef)imageBuffer;
/**
* This method will attempt to start an audio session
*
* @param startBlock A block that will be called with the result of attempting to start an audio session
*/
- (void)startAudioSessionWithStartBlock:(SDLStreamingStartBlock)startBlock;
// TODO: Documentation
- (void)startAudioSessionWithTLS:(SDLEncryptionFlag)encryptionFlag startBlock:(SDLStreamingEncryptionStartBlock)startBlock;
/**
* This method will stop a running audio session if there is one running.
*/
- (void)stopAudioSession;
/**
* This method receives PCM audio data and will attempt to send that data across to the head unit for immediate playback
*
* @param pcmAudioData The data in PCM audio format, to be played
*
* @return Whether or not the data was successfully sent.
*/
- (BOOL)sendAudioData:(NSData *)pcmAudioData;
@end
NS_ASSUME_NONNULL_END
|
