1. ホーム
  2. youtube-api

[解決済み] YouTube Live API ストリームの状態と品質のコールバック

2022-03-02 10:03:12

質問

YouTube Live放送のquot;Live Control Room"で、YouTubeのRTMPエンドポイントに送信されるビデオの詳細を示すquot;Stream Status"が表示されますが、これは何ですか?

を押すと ライブストリーム エンドポイントからストリームの状態を取得しようとしましたが、返されるのは active これは、ビデオ ストリームが YouTube の RTMP エンドポイントに正常に送信されていることを意味しますが、ビデオ データや品質に関する情報はありません。

この情報は、APIのどこかで公開されているのでしょうか?また、エンコーダーが正しく動作していることを確認するために、YouTube に送信されるビットレート、fps などの動画に関する詳細情報を確認することはできますか?あるいは、そのチェックはクライアント側で行う必要があり、エンコーダを出た直後のビデオをチェックして、RTMP エンドポイントをヒットさせる必要があるのでしょうか。私はiOSアプリケーションを書いているので、Web上で"Live Control Room"を使用することは、私にとって現実的な解決策ではありません。

放送側でliveStreamの状態を確認するために行っていることは、以下の通りです。

- (void)checkStreamStatus {
    [self getRequestWithURL:[NSString stringWithFormat:@"https://www.googleapis.com/youtube/v3/liveStreams?part=id,snippet,cdn,status&id=%@", self.liveStreamId] andBlock:^(NSDictionary *responseDict) {
        NSLog(@"response: %@", responseDict);

        // if stream is active, youtube is receiving data from our encoder
        // ready to transition to live
        NSArray *items = [responseDict objectForKey:@"items"];
        NSDictionary *itemsDict = [items firstObject];
        NSDictionary *statusDict = [itemsDict objectForKey:@"status"];
        if ([[statusDict objectForKey:@"streamStatus"] isEqualToString:@"active"]) {
            NSLog(@"stream ready to go live!");
            if (!userIsLive) {
                [self goLive]; // transition the broadcastStatus from "testing" to "live"
            }
        } else {
            NSLog(@"keep refreshing, broadcast object not ready on youtube's end");
        }
    }];
}

getRequestWithURL は、GET リクエストを行うために私が作成した汎用的なメソッドに過ぎません。

- (void)getRequestWithURL:(NSString *)urlStr andBlock:(void (^)(NSDictionary *responseDict))completion {

    NSURL *url = [NSURL URLWithString:urlStr];
    NSMutableURLRequest * request = [NSMutableURLRequest requestWithURL:url];

    [request addValue:[NSString stringWithFormat:@"Bearer %@", [[NSUserDefaults standardUserDefaults] objectForKey:@"accessToken"]] forHTTPHeaderField:@"Authorization"];

    [request setHTTPMethod:@"GET"];

    // Set the content type
    [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

    [NSURLConnection sendAsynchronousRequest:request queue:[[NSOperationQueue alloc] init] completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
        [self parseJSONwithData:data andBlock:completion];

    }];
}

- (void)parseJSONwithData:(NSData *)data andBlock:(void (^)(NSDictionary * responseDict))completion {
    NSError *error = nil;
    NSDictionary *responseDict = [NSJSONSerialization JSONObjectWithData:data
                                                                 options:kNilOptions
                                                                   error:&error];
    if (error) {
        NSLog(@"error: %@", [error localizedDescription]);
    }
    completion(responseDict);
}

コンシューマー側で動画の画質を確認するためにやっていることは、こんな感じです。

を使用しています。 YTPlayerView のライブラリは、Googleから提供されています。

- (void)notifyDelegateOfYouTubeCallbackUrl: (NSURL *) url {
  NSString *action = url.host;

  // We know the query can only be of the format http://ytplayer?data=SOMEVALUE,
  // so we parse out the value.
  NSString *query = url.query;
  NSString *data;
  if (query) {
    data = [query componentsSeparatedByString:@"="][4]; // data here is auto, meaning auto quality
  }
  ...
  if ([action isEqual:kYTPlayerCallbackOnPlaybackQualityChange]) {
    if ([self.delegate respondsToSelector:@selector(playerView:didChangeToQuality:)]) {
    YTPlaybackQuality quality = [YTPlayerView playbackQualityForString:data];
    [self.delegate playerView:self didChangeToQuality:quality];
  }
  ...
}

しかし、品質 "auto" は、このライブラリでサポートされている品質定数ではないようです。

// Constants representing playback quality.
NSString static *const kYTPlaybackQualitySmallQuality = @"small";
NSString static *const kYTPlaybackQualityMediumQuality = @"medium";
NSString static *const kYTPlaybackQualityLargeQuality = @"large";
NSString static *const kYTPlaybackQualityHD720Quality = @"hd720";
NSString static *const kYTPlaybackQualityHD1080Quality = @"hd1080";
NSString static *const kYTPlaybackQualityHighResQuality = @"highres";
NSString static *const kYTPlaybackQualityUnknownQuality = @"unknown";

...
@implementation YTPlayerView
...

/**
 * Convert a quality value from NSString to the typed enum value.
 *
 * @param qualityString A string representing playback quality. Ex: "small", "medium", "hd1080".
 * @return An enum value representing the playback quality.
 */
+ (YTPlaybackQuality)playbackQualityForString:(NSString *)qualityString {
  YTPlaybackQuality quality = kYTPlaybackQualityUnknown;

  if ([qualityString isEqualToString:kYTPlaybackQualitySmallQuality]) {
    quality = kYTPlaybackQualitySmall;
  } else if ([qualityString isEqualToString:kYTPlaybackQualityMediumQuality]) {
    quality = kYTPlaybackQualityMedium;
  } else if ([qualityString isEqualToString:kYTPlaybackQualityLargeQuality]) {
    quality = kYTPlaybackQualityLarge;
  } else if ([qualityString isEqualToString:kYTPlaybackQualityHD720Quality]) {
    quality = kYTPlaybackQualityHD720;
  } else if ([qualityString isEqualToString:kYTPlaybackQualityHD1080Quality]) {
    quality = kYTPlaybackQualityHD1080;
  } else if ([qualityString isEqualToString:kYTPlaybackQualityHighResQuality]) {
    quality = kYTPlaybackQualityHighRes;
  }

  return quality;
}

を作成しました。 問題 を、このプロジェクトのGitHubページに追加しました。

解決方法は?

からの返信を受け取りました。 イブラヒム・ウルカヤ この問題について

我々は、その呼び出しに詳細な情報を持っていることを望んでいるが、基本的にアクティブは良いストリーミングを示し、あなたのストリーミング情報は、次のとおりです。 https://developers.google.com/youtube/v3/live/docs/liveStreams#cdn.format を設定し、そのフォーマットを見ることができます。

つまり、当面の間、YouTube Livestreaming APIからこの情報を入手することはできません。 APIが更新されたら、この回答を更新する予定です。