iOS Streamer¶

Пример стримера для iOS¶

Данный стример может использоваться для публикации WebRTC-видеопотока на Web Call Server.

На скриншоте ниже представлен пример во время публикации потока.

В URL в поле ввода

192.168.2.107 - адрес WCS-сервера
testStream - имя потока

Слева отображается видео с камеры, справа воспроизводится опубликованный поток.

Работа с кодом примера¶

Для разбора кода возьмем версию примера Streamer, которая доступна здесь.

Класс для основного вида приложения: ViewController (заголовочный файл ViewController.h; файл имплементации ViewController.m).

1. Импорт API¶

code

#import <FPWCSApi2/FPWCSApi2.h>

2. Создание сессии¶

FPWCSApi2.createSession code

В параметрах сессии указываются:

URL WCS-сервера
имя серверного приложения defaultApp

FPWCSApi2SessionOptions *options = [[FPWCSApi2SessionOptions alloc] init];
NSURL *url =[[NSURL alloc] initWithString:_connectUrl.text];
options.urlServer = [NSString stringWithFormat:@"%@://%@:%@", url.scheme, url.host, url.port];
streamName = [url.path.stringByDeletingPathExtension stringByReplacingOccurrencesOfString: @"/" withString:@""];
options.appKey = @"defaultApp";
NSError *error;
session = [FPWCSApi2 createSession:options error:&error];

3. Подключение к серверу¶

FPWCSApi2Session.connect code

[session connect];

4. Получение от сервера события, подтверждающего успешное соединение¶

FPWCSApi2Session.onConnected code

При получении данного события вызывается метод публикации потока publishStream

- (void)onConnected:(FPWCSApi2Session *)session {
    [_connectButton setTitle:@"STOP" forState:UIControlStateNormal];
   // [self changeViewState:_connectButton enabled:YES];
    [self publishStream];
}

5. Публикация видеопотока¶

FPWCSApi2Session.createStream, FPWCSApi2Stream.publish code

Методу createStream передаются параметры:

имя публикуемого потока
вид для локального отображения
параметры видео (в примере задается разрешение для публикации с iPad)

- (FPWCSApi2Stream *)publishStream {
    FPWCSApi2Session *session = [FPWCSApi2 getSessions][0];
    FPWCSApi2StreamOptions *options = [[FPWCSApi2StreamOptions alloc] init];
    options.name = streamName;
    options.display = _videoView.local;
    if ( UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad ) {
        options.constraints = [[FPWCSApi2MediaConstraints alloc] initWithAudio:YES videoWidth:640 videoHeight:480 videoFps:15];
    }
    NSError *error;
    publishStream = [session createStream:options error:&error];
    ...
    if(![publishStream publish:&error]) {
        UIAlertController * alert = [UIAlertController
                                     alertControllerWithTitle:@"Failed to publish"
                                     message:error.localizedDescription
                                     preferredStyle:UIAlertControllerStyleAlert];

        UIAlertAction* okButton = [UIAlertAction
                                    actionWithTitle:@"Ok"
                                    style:UIAlertActionStyleDefault
                                    handler:^(UIAlertAction * action) {
                                        [self onUnpublished];
                                    }];

        [alert addAction:okButton];
        [self presentViewController:alert animated:YES completion:nil];
    }
    return publishStream;
}

6. Получение от сервера события, подтверждающего успешную публикацию¶

FPWCSApi2Stream.onPublishing code

При получении данного события вызывается метод воспроизведения потока playStream

- (void)onPublishing:(FPWCSApi2Stream *)stream {
    [self playStream];
}

7. Воспроизведение видеопотока¶

FPWCSApi2Session.createStream, FPWCSApi2Stream.play code

Методу createStream передаются параметры:

имя воспроизводимого потока
вид для отображения потока

- (FPWCSApi2Stream *)playStream {
    FPWCSApi2Session *session = [FPWCSApi2 getSessions][0];
    FPWCSApi2StreamOptions *options = [[FPWCSApi2StreamOptions alloc] init];
    options.name = streamName;
    options.display = _videoView.remote;
    NSError *error;
    playStream = [session createStream:options error:nil];
    ...
    if(![playStream play:&error]) {
        UIAlertController * alert = [UIAlertController
                                     alertControllerWithTitle:@"Failed to play"
                                     message:error.localizedDescription
                                     preferredStyle:UIAlertControllerStyleAlert];

        UIAlertAction* okButton = [UIAlertAction
                                   actionWithTitle:@"Ok"
                                   style:UIAlertActionStyleDefault
                                   handler:^(UIAlertAction * action) {

                                   }];

        [alert addAction:okButton];
        [self presentViewController:alert animated:YES completion:nil];
    }
    return playStream;
}

8. Закрытие соединения¶

FPWCSApi2Session.disconnect code

- (void)connectButton:(UIButton *)button {
    [self changeViewState:button enabled:NO];
    if ([button.titleLabel.text isEqualToString:@"STOP"]) {
        if ([FPWCSApi2 getSessions].count) {
            FPWCSApi2Session *session = [FPWCSApi2 getSessions][0];
            NSLog(@"Disconnect session with server %@", [session getServerUrl]);
            [session disconnect];
        } else {
            NSLog(@"Nothing to disconnect");
            [self onDisconnected];
        }
    } else {
        //todo check url is not empty
        [self changeViewState:_connectUrl enabled:NO];
        [self connect];
    }
}

9. Получение события, подтверждающего разъединение¶

ViewController.onDisconnected code

- (void)onDisconnected {
    [_connectButton setTitle:@"START" forState:UIControlStateNormal];
    [self changeViewState:_connectButton enabled:YES];
    [self changeViewState:_connectUrl enabled:YES];
    [self onUnpublished];
    [self onStopped];
}