Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2015 The WebRTC project authors. All Rights Reserved. |
| 3 | * |
| 4 | * Use of this source code is governed by a BSD-style license |
| 5 | * that can be found in the LICENSE file in the root of the source |
| 6 | * tree. An additional intellectual property rights grant can be found |
| 7 | * in the file PATENTS. All contributing project authors may |
| 8 | * be found in the AUTHORS file in the root of the source tree. |
| 9 | */ |
| 10 | |
magjed | b8853ca | 2017-08-29 03:57:22 -0700 | [diff] [blame] | 11 | #import "RTCPeerConnectionFactory+Native.h" |
tkchin | 9eeb624 | 2016-04-27 01:54:20 -0700 | [diff] [blame] | 12 | #import "RTCPeerConnectionFactory+Private.h" |
Yura Yaroshevich | bf56712 | 2018-01-02 13:33:16 +0300 | [diff] [blame] | 13 | #import "RTCPeerConnectionFactoryOptions+Private.h" |
Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 14 | |
tkchin | d4bfbfc | 2016-08-30 11:56:05 -0700 | [diff] [blame] | 15 | #import "RTCAudioSource+Private.h" |
tkchin | 9eeb624 | 2016-04-27 01:54:20 -0700 | [diff] [blame] | 16 | #import "RTCAudioTrack+Private.h" |
tkchin | d4bfbfc | 2016-08-30 11:56:05 -0700 | [diff] [blame] | 17 | #import "RTCMediaConstraints+Private.h" |
tkchin | 9eeb624 | 2016-04-27 01:54:20 -0700 | [diff] [blame] | 18 | #import "RTCMediaStream+Private.h" |
| 19 | #import "RTCPeerConnection+Private.h" |
| 20 | #import "RTCVideoSource+Private.h" |
| 21 | #import "RTCVideoTrack+Private.h" |
Anders Carlsson | 7bca8ca | 2018-08-30 09:30:29 +0200 | [diff] [blame] | 22 | #import "base/RTCLogging.h" |
| 23 | #import "base/RTCVideoDecoderFactory.h" |
| 24 | #import "base/RTCVideoEncoderFactory.h" |
| 25 | #import "helpers/NSString+StdString.h" |
kthelgason | fb14312 | 2017-07-25 07:55:58 -0700 | [diff] [blame] | 26 | #ifndef HAVE_NO_MEDIA |
Anders Carlsson | 7bca8ca | 2018-08-30 09:30:29 +0200 | [diff] [blame] | 27 | #import "components/video_codec/RTCVideoDecoderFactoryH264.h" |
| 28 | #import "components/video_codec/RTCVideoEncoderFactoryH264.h" |
magjed | b8853ca | 2017-08-29 03:57:22 -0700 | [diff] [blame] | 29 | // The no-media version PeerConnectionFactory doesn't depend on these files, but the gn check tool |
| 30 | // is not smart enough to take the #ifdef into account. |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 31 | #include "api/audio_codecs/builtin_audio_decoder_factory.h" // nogncheck |
| 32 | #include "api/audio_codecs/builtin_audio_encoder_factory.h" // nogncheck |
Anders Carlsson | 565e3e0 | 2018-01-19 11:36:48 +0100 | [diff] [blame] | 33 | #include "media/engine/convert_legacy_video_factory.h" // nogncheck |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 34 | #include "modules/audio_device/include/audio_device.h" // nogncheck |
| 35 | #include "modules/audio_processing/include/audio_processing.h" // nogncheck |
Anders Carlsson | 3ff50fb | 2018-02-01 15:47:05 +0100 | [diff] [blame] | 36 | |
Anders Carlsson | 7bca8ca | 2018-08-30 09:30:29 +0200 | [diff] [blame] | 37 | #include "sdk/objc/native/api/video_decoder_factory.h" |
| 38 | #include "sdk/objc/native/api/video_encoder_factory.h" |
| 39 | #include "sdk/objc/native/src/objc_video_decoder_factory.h" |
| 40 | #include "sdk/objc/native/src/objc_video_encoder_factory.h" |
kthelgason | fb14312 | 2017-07-25 07:55:58 -0700 | [diff] [blame] | 41 | #endif |
kwiberg | bfefb03 | 2016-05-01 14:53:46 -0700 | [diff] [blame] | 42 | |
Peter Hanspers | 8d95e3b | 2018-05-15 10:22:36 +0200 | [diff] [blame] | 43 | #if defined(WEBRTC_IOS) |
Anders Carlsson | 7bca8ca | 2018-08-30 09:30:29 +0200 | [diff] [blame] | 44 | #import "sdk/objc/native/api/audio_device_module.h" |
Peter Hanspers | 8d95e3b | 2018-05-15 10:22:36 +0200 | [diff] [blame] | 45 | #endif |
| 46 | |
zhihuang | a4c113a | 2017-06-28 14:05:44 -0700 | [diff] [blame] | 47 | // Adding the nogncheck to disable the including header check. |
| 48 | // The no-media version PeerConnectionFactory doesn't depend on media related |
| 49 | // C++ target. |
| 50 | // TODO(zhihuang): Remove nogncheck once MediaEngineInterface is moved to C++ |
| 51 | // API layer. |
Karl Wiberg | 918f50c | 2018-07-05 11:40:33 +0200 | [diff] [blame] | 52 | #include "absl/memory/memory.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 53 | #include "media/engine/webrtcmediaengine.h" // nogncheck |
Kári Tristan Helgason | cbe7435 | 2016-11-09 10:43:26 +0100 | [diff] [blame] | 54 | |
Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 55 | @implementation RTCPeerConnectionFactory { |
danilchap | e9021a3 | 2016-05-17 01:52:02 -0700 | [diff] [blame] | 56 | std::unique_ptr<rtc::Thread> _networkThread; |
kwiberg | bfefb03 | 2016-05-01 14:53:46 -0700 | [diff] [blame] | 57 | std::unique_ptr<rtc::Thread> _workerThread; |
danilchap | e9021a3 | 2016-05-17 01:52:02 -0700 | [diff] [blame] | 58 | std::unique_ptr<rtc::Thread> _signalingThread; |
tkchin | fce0e2c | 2016-08-30 12:58:11 -0700 | [diff] [blame] | 59 | BOOL _hasStartedAecDump; |
Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 60 | } |
| 61 | |
| 62 | @synthesize nativeFactory = _nativeFactory; |
| 63 | |
Peter Hanspers | 8d95e3b | 2018-05-15 10:22:36 +0200 | [diff] [blame] | 64 | - (rtc::scoped_refptr<webrtc::AudioDeviceModule>)audioDeviceModule { |
| 65 | #if defined(WEBRTC_IOS) |
| 66 | return webrtc::CreateAudioDeviceModule(); |
| 67 | #else |
| 68 | return nullptr; |
| 69 | #endif |
| 70 | } |
| 71 | |
Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 72 | - (instancetype)init { |
kthelgason | fb14312 | 2017-07-25 07:55:58 -0700 | [diff] [blame] | 73 | #ifdef HAVE_NO_MEDIA |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 74 | return [self initWithNoMedia]; |
Magnus Jedvert | 8b4e92d | 2018-04-13 15:36:43 +0200 | [diff] [blame] | 75 | #else |
Anders Carlsson | dd8c165 | 2018-01-30 10:32:13 +0100 | [diff] [blame] | 76 | return [self initWithNativeAudioEncoderFactory:webrtc::CreateBuiltinAudioEncoderFactory() |
| 77 | nativeAudioDecoderFactory:webrtc::CreateBuiltinAudioDecoderFactory() |
Anders Carlsson | 3ff50fb | 2018-02-01 15:47:05 +0100 | [diff] [blame] | 78 | nativeVideoEncoderFactory:webrtc::ObjCToNativeVideoEncoderFactory( |
| 79 | [[RTCVideoEncoderFactoryH264 alloc] init]) |
| 80 | nativeVideoDecoderFactory:webrtc::ObjCToNativeVideoDecoderFactory( |
| 81 | [[RTCVideoDecoderFactoryH264 alloc] init]) |
Peter Hanspers | 8d95e3b | 2018-05-15 10:22:36 +0200 | [diff] [blame] | 82 | audioDeviceModule:[self audioDeviceModule] |
Anders Carlsson | dd8c165 | 2018-01-30 10:32:13 +0100 | [diff] [blame] | 83 | audioProcessingModule:nullptr]; |
kthelgason | fb14312 | 2017-07-25 07:55:58 -0700 | [diff] [blame] | 84 | #endif |
| 85 | } |
| 86 | |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 87 | - (instancetype)initWithEncoderFactory:(nullable id<RTCVideoEncoderFactory>)encoderFactory |
| 88 | decoderFactory:(nullable id<RTCVideoDecoderFactory>)decoderFactory { |
magjed | b8853ca | 2017-08-29 03:57:22 -0700 | [diff] [blame] | 89 | #ifdef HAVE_NO_MEDIA |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 90 | return [self initWithNoMedia]; |
magjed | b8853ca | 2017-08-29 03:57:22 -0700 | [diff] [blame] | 91 | #else |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 92 | std::unique_ptr<webrtc::VideoEncoderFactory> native_encoder_factory; |
| 93 | std::unique_ptr<webrtc::VideoDecoderFactory> native_decoder_factory; |
| 94 | if (encoderFactory) { |
Anders Carlsson | 3ff50fb | 2018-02-01 15:47:05 +0100 | [diff] [blame] | 95 | native_encoder_factory = webrtc::ObjCToNativeVideoEncoderFactory(encoderFactory); |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 96 | } |
| 97 | if (decoderFactory) { |
Anders Carlsson | 3ff50fb | 2018-02-01 15:47:05 +0100 | [diff] [blame] | 98 | native_decoder_factory = webrtc::ObjCToNativeVideoDecoderFactory(decoderFactory); |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 99 | } |
magjed | b8853ca | 2017-08-29 03:57:22 -0700 | [diff] [blame] | 100 | return [self initWithNativeAudioEncoderFactory:webrtc::CreateBuiltinAudioEncoderFactory() |
| 101 | nativeAudioDecoderFactory:webrtc::CreateBuiltinAudioDecoderFactory() |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 102 | nativeVideoEncoderFactory:std::move(native_encoder_factory) |
Sean Rosenbaum | e5c4265 | 2017-10-30 07:50:17 -0700 | [diff] [blame] | 103 | nativeVideoDecoderFactory:std::move(native_decoder_factory) |
Peter Hanspers | 8d95e3b | 2018-05-15 10:22:36 +0200 | [diff] [blame] | 104 | audioDeviceModule:[self audioDeviceModule] |
Sam Zackrisson | 6124aac | 2017-11-13 14:56:02 +0100 | [diff] [blame] | 105 | audioProcessingModule:nullptr]; |
magjed | b8853ca | 2017-08-29 03:57:22 -0700 | [diff] [blame] | 106 | #endif |
| 107 | } |
| 108 | |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 109 | - (instancetype)initNative { |
kthelgason | fb14312 | 2017-07-25 07:55:58 -0700 | [diff] [blame] | 110 | if (self = [super init]) { |
danilchap | e9021a3 | 2016-05-17 01:52:02 -0700 | [diff] [blame] | 111 | _networkThread = rtc::Thread::CreateWithSocketServer(); |
Yura Yaroshevich | cef0650 | 2018-05-01 00:58:43 +0300 | [diff] [blame] | 112 | _networkThread->SetName("network_thread", _networkThread.get()); |
danilchap | e9021a3 | 2016-05-17 01:52:02 -0700 | [diff] [blame] | 113 | BOOL result = _networkThread->Start(); |
| 114 | NSAssert(result, @"Failed to start network thread."); |
| 115 | |
| 116 | _workerThread = rtc::Thread::Create(); |
Yura Yaroshevich | cef0650 | 2018-05-01 00:58:43 +0300 | [diff] [blame] | 117 | _workerThread->SetName("worker_thread", _workerThread.get()); |
Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 118 | result = _workerThread->Start(); |
| 119 | NSAssert(result, @"Failed to start worker thread."); |
| 120 | |
danilchap | e9021a3 | 2016-05-17 01:52:02 -0700 | [diff] [blame] | 121 | _signalingThread = rtc::Thread::Create(); |
Yura Yaroshevich | cef0650 | 2018-05-01 00:58:43 +0300 | [diff] [blame] | 122 | _signalingThread->SetName("signaling_thread", _signalingThread.get()); |
danilchap | e9021a3 | 2016-05-17 01:52:02 -0700 | [diff] [blame] | 123 | result = _signalingThread->Start(); |
| 124 | NSAssert(result, @"Failed to start signaling thread."); |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 125 | } |
| 126 | return self; |
| 127 | } |
| 128 | |
| 129 | - (instancetype)initWithNoMedia { |
| 130 | if (self = [self initNative]) { |
zhihuang | a4c113a | 2017-06-28 14:05:44 -0700 | [diff] [blame] | 131 | _nativeFactory = webrtc::CreateModularPeerConnectionFactory( |
| 132 | _networkThread.get(), |
| 133 | _workerThread.get(), |
| 134 | _signalingThread.get(), |
zhihuang | a4c113a | 2017-06-28 14:05:44 -0700 | [diff] [blame] | 135 | std::unique_ptr<cricket::MediaEngineInterface>(), |
| 136 | std::unique_ptr<webrtc::CallFactoryInterface>(), |
| 137 | std::unique_ptr<webrtc::RtcEventLogFactoryInterface>()); |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 138 | NSAssert(_nativeFactory, @"Failed to initialize PeerConnectionFactory!"); |
| 139 | } |
| 140 | return self; |
| 141 | } |
| 142 | |
| 143 | - (instancetype)initWithNativeAudioEncoderFactory: |
| 144 | (rtc::scoped_refptr<webrtc::AudioEncoderFactory>)audioEncoderFactory |
| 145 | nativeAudioDecoderFactory: |
| 146 | (rtc::scoped_refptr<webrtc::AudioDecoderFactory>)audioDecoderFactory |
| 147 | nativeVideoEncoderFactory: |
| 148 | (std::unique_ptr<webrtc::VideoEncoderFactory>)videoEncoderFactory |
| 149 | nativeVideoDecoderFactory: |
Sean Rosenbaum | e5c4265 | 2017-10-30 07:50:17 -0700 | [diff] [blame] | 150 | (std::unique_ptr<webrtc::VideoDecoderFactory>)videoDecoderFactory |
| 151 | audioDeviceModule: |
Sam Zackrisson | 6124aac | 2017-11-13 14:56:02 +0100 | [diff] [blame] | 152 | (nullable webrtc::AudioDeviceModule *)audioDeviceModule |
| 153 | audioProcessingModule: |
| 154 | (rtc::scoped_refptr<webrtc::AudioProcessing>)audioProcessingModule { |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 155 | #ifdef HAVE_NO_MEDIA |
| 156 | return [self initWithNoMedia]; |
zhihuang | a4c113a | 2017-06-28 14:05:44 -0700 | [diff] [blame] | 157 | #else |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 158 | if (self = [self initNative]) { |
| 159 | _nativeFactory = webrtc::CreatePeerConnectionFactory(_networkThread.get(), |
| 160 | _workerThread.get(), |
| 161 | _signalingThread.get(), |
Sean Rosenbaum | e5c4265 | 2017-10-30 07:50:17 -0700 | [diff] [blame] | 162 | audioDeviceModule, |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 163 | audioEncoderFactory, |
| 164 | audioDecoderFactory, |
| 165 | std::move(videoEncoderFactory), |
| 166 | std::move(videoDecoderFactory), |
| 167 | nullptr, // audio mixer |
Sam Zackrisson | 6124aac | 2017-11-13 14:56:02 +0100 | [diff] [blame] | 168 | audioProcessingModule); |
Anders Carlsson | 7e04281 | 2017-10-05 16:55:38 +0200 | [diff] [blame] | 169 | NSAssert(_nativeFactory, @"Failed to initialize PeerConnectionFactory!"); |
| 170 | } |
| 171 | return self; |
| 172 | #endif |
| 173 | } |
| 174 | |
tkchin | d4bfbfc | 2016-08-30 11:56:05 -0700 | [diff] [blame] | 175 | - (RTCAudioSource *)audioSourceWithConstraints:(nullable RTCMediaConstraints *)constraints { |
| 176 | std::unique_ptr<webrtc::MediaConstraints> nativeConstraints; |
| 177 | if (constraints) { |
| 178 | nativeConstraints = constraints.nativeConstraints; |
| 179 | } |
Niels Möller | 2d02e08 | 2018-05-21 11:23:35 +0200 | [diff] [blame] | 180 | cricket::AudioOptions options; |
| 181 | CopyConstraintsIntoAudioOptions(nativeConstraints.get(), &options); |
| 182 | |
tkchin | d4bfbfc | 2016-08-30 11:56:05 -0700 | [diff] [blame] | 183 | rtc::scoped_refptr<webrtc::AudioSourceInterface> source = |
Niels Möller | 2d02e08 | 2018-05-21 11:23:35 +0200 | [diff] [blame] | 184 | _nativeFactory->CreateAudioSource(options); |
Yura Yaroshevich | 01cee07 | 2018-07-11 15:35:40 +0300 | [diff] [blame] | 185 | return [[RTCAudioSource alloc] initWithFactory:self nativeAudioSource:source]; |
tkchin | d4bfbfc | 2016-08-30 11:56:05 -0700 | [diff] [blame] | 186 | } |
| 187 | |
| 188 | - (RTCAudioTrack *)audioTrackWithTrackId:(NSString *)trackId { |
| 189 | RTCAudioSource *audioSource = [self audioSourceWithConstraints:nil]; |
| 190 | return [self audioTrackWithSource:audioSource trackId:trackId]; |
| 191 | } |
| 192 | |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 193 | - (RTCAudioTrack *)audioTrackWithSource:(RTCAudioSource *)source |
| 194 | trackId:(NSString *)trackId { |
| 195 | return [[RTCAudioTrack alloc] initWithFactory:self |
| 196 | source:source |
| 197 | trackId:trackId]; |
tkchin | d4bfbfc | 2016-08-30 11:56:05 -0700 | [diff] [blame] | 198 | } |
| 199 | |
magjed | abb84b8 | 2017-03-28 01:56:41 -0700 | [diff] [blame] | 200 | - (RTCVideoSource *)videoSource { |
Yura Yaroshevich | 01cee07 | 2018-07-11 15:35:40 +0300 | [diff] [blame] | 201 | return [[RTCVideoSource alloc] initWithFactory:self |
| 202 | signalingThread:_signalingThread.get() |
| 203 | workerThread:_workerThread.get()]; |
magjed | abb84b8 | 2017-03-28 01:56:41 -0700 | [diff] [blame] | 204 | } |
| 205 | |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 206 | - (RTCVideoTrack *)videoTrackWithSource:(RTCVideoSource *)source |
| 207 | trackId:(NSString *)trackId { |
| 208 | return [[RTCVideoTrack alloc] initWithFactory:self |
| 209 | source:source |
| 210 | trackId:trackId]; |
Tze Kwang Chin | f3cb49f | 2016-03-22 10:57:40 -0700 | [diff] [blame] | 211 | } |
| 212 | |
| 213 | - (RTCMediaStream *)mediaStreamWithStreamId:(NSString *)streamId { |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 214 | return [[RTCMediaStream alloc] initWithFactory:self |
| 215 | streamId:streamId]; |
Tze Kwang Chin | f3cb49f | 2016-03-22 10:57:40 -0700 | [diff] [blame] | 216 | } |
| 217 | |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 218 | - (RTCPeerConnection *)peerConnectionWithConfiguration: |
| 219 | (RTCConfiguration *)configuration |
| 220 | constraints: |
| 221 | (RTCMediaConstraints *)constraints |
Tze Kwang Chin | f3cb49f | 2016-03-22 10:57:40 -0700 | [diff] [blame] | 222 | delegate: |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 223 | (nullable id<RTCPeerConnectionDelegate>)delegate { |
Tze Kwang Chin | f3cb49f | 2016-03-22 10:57:40 -0700 | [diff] [blame] | 224 | return [[RTCPeerConnection alloc] initWithFactory:self |
| 225 | configuration:configuration |
| 226 | constraints:constraints |
| 227 | delegate:delegate]; |
| 228 | } |
| 229 | |
Yura Yaroshevich | bf56712 | 2018-01-02 13:33:16 +0300 | [diff] [blame] | 230 | - (void)setOptions:(nonnull RTCPeerConnectionFactoryOptions *)options { |
| 231 | RTC_DCHECK(options != nil); |
| 232 | _nativeFactory->SetOptions(options.nativeOptions); |
| 233 | } |
| 234 | |
Magnus Jedvert | f83dc8b | 2017-08-29 09:49:43 +0000 | [diff] [blame] | 235 | - (BOOL)startAecDumpWithFilePath:(NSString *)filePath |
| 236 | maxSizeInBytes:(int64_t)maxSizeInBytes { |
tkchin | fce0e2c | 2016-08-30 12:58:11 -0700 | [diff] [blame] | 237 | RTC_DCHECK(filePath.length); |
| 238 | RTC_DCHECK_GT(maxSizeInBytes, 0); |
| 239 | |
| 240 | if (_hasStartedAecDump) { |
| 241 | RTCLogError(@"Aec dump already started."); |
| 242 | return NO; |
| 243 | } |
| 244 | int fd = open(filePath.UTF8String, O_WRONLY | O_CREAT | O_TRUNC, S_IRUSR | S_IWUSR); |
| 245 | if (fd < 0) { |
| 246 | RTCLogError(@"Error opening file: %@. Error: %d", filePath, errno); |
| 247 | return NO; |
| 248 | } |
| 249 | _hasStartedAecDump = _nativeFactory->StartAecDump(fd, maxSizeInBytes); |
| 250 | return _hasStartedAecDump; |
| 251 | } |
| 252 | |
| 253 | - (void)stopAecDump { |
| 254 | _nativeFactory->StopAecDump(); |
| 255 | _hasStartedAecDump = NO; |
| 256 | } |
| 257 | |
Jon Hjelle | da99da8 | 2016-01-20 13:40:30 -0800 | [diff] [blame] | 258 | @end |