mildom 1.3

Unofficial wrapper for mildom api.

これは何？

Python用Mildom APIの非公式ライブラリです。 開発途中です。
バグがあればGithubのissueをお願いします。
This is an unofficial api wrapper for Mildom. If you find any bugs, please report it on issues by English or Japanese.

対応状況

• ProfileV2 API
• PlayBack API (配信アーカイブ)
  • アーカイブの範囲取得
• EnterStudio API (ライブ配信)

対応予定

• async/await(非同期処理)

注意

あくまでも非公式APIの非公式ラッパーです。開発が継続される保証はありません。 開発者は募集中です。
※バージョン2.0には破壊的変更を含む予定です。

使い方

• ユーザーオブジェクトを作成して詳細を取得
  情報を更新する時は、User.updateで情報を更新できます。

Userオブジェクト -ProfileV2 API-

import mildom
user_id = 12345678

# 8桁のIDを指定してユーザーオブジェクトを作成
user = mildom.User(user_id)

Examples:

# bool値でライブ中かどうかを取得
print(user.is_live)

# プロフィールの画像URLを取得
print(user.avatar_url)

# レベルを取得
print(user.level)

• ライブ中かどうかだけを取得

import mildom
user_id = 12345678

if mildom.is_live(user_id):
    print('now on live')

PlayBack(アーカイブ)オブジェクト -PlayBack API-

• 複数のアーカイブをリストで取得

import mildom
user_id = 12345678
user = mildom.User(user_id)

# "limit" argument is optional.
playback_list: list = user.fetch_playback(limit=10)

• 特定のアーカイブを取得(fetch specific PlayBack)

import mildom
user_id = 12345678
user = mildom.User(user_id)

# index starts from 0.
playback = user.fetch_playback(index=10)

Examples:

# URLを取得
print(playback.url)
# タイトルを取得
print(playback.title)
# MP4のURLを取得
print(playback.source_url)

注意

「最新から2番目のアーカイブを取得したい」といった場合にはindexを指定してください。
使用しているAPIが異なるため、レスポンスを高速化できます。
以下は指定範囲のアーカイブをランダムに取得するテストにおけるレスポンス時間の平均値です。

0~425
index api time: 0.045539161014556885
----------------------------------------------
legacy api time: 0.06734103298187255


200~425
index api time: 0.049199145197868346
----------------------------------------------
legacy api time: 0.08169150960445404

300~425
index api time: 0.049523269319534304
----------------------------------------------
legacy api time: 0.10116533222198486

LiveStream(ライブ配信)オブジェクト -EnterStudio API-

import mildom
live_stream = mildom.LiveStream(user_id)

# 配信状況を取得
print(live_stream.is_live)
# タイトルを取得
print(live_stream.title)
# m3u8形式でストリーミングのURLを取得(VLCなどで再生可能)
if live_stream.is_dvr_enabled:
    # 配信者がDVRを有効にしていないと取得不可
    video_stream_links = live_stream.dvr_videos