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の非公式ラッパーです。開発が継続される保証はありません。
This is unofficial wrapper. There is no guarantee of continuous development.
※バージョン2.0でDiscord Bot等で使用可能なasyncモジュールを入れる予定です。
- 下の例に沿って各種オブジェクトを生成して使用する。
Use as the instruction below. - mildom.api_request から各種APIのレスポンスをJSON(dict)で受け取る。
Use mildom.api_request to get API response as json(dict).
情報を更新する時は、User.updateで情報を更新できます。
You can refresh the data with User.update.
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)
- ライブ中かどうかだけを取得 -get only if it's streaming or not-
import mildom
user_id = 12345678
if mildom.is_live(user_id):
print('now on live')
- 複数のアーカイブをリストで取得 -get multiple playbacks as a list-
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
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
category引数に指定できるstr一覧
List of str that can be used as the category argument.
["user", "live_stream", "video", "playback", "recommended_live_stream", "clip_video"]
import mildom
search_result: mildom.SearchResult = mildom.search("query")
search_result_with_category_specified = mildom.search("query", category="user")
SearchResultオブジェクトの値一覧
List of variables of SearchResult object.
SearchResult.clip_videos: list
SearchResult.live_streams: list
SearchResult.recommended_live_streams: list
SearchResult.videos: list
SearchResult.users: list
SearchResult.playbacks: list