网易云音乐PHP版APIライブラリ

Library

概要

「Neteaseflc_php」は、中国の大手音楽配信サービス「网易云音乐(NetEase Cloud Music)」向けの非公式APIをPHPで実装したライブラリです。音楽再生用のリンクを多彩な音質で取得可能なほか、楽曲詳細情報、歌詞(通常歌詞、翻訳歌詞、ローマ字表記)、楽曲検索、プレイリストやアルバムの情報取得など、多様な機能を備えています。さらにクッキーを利用したログイン状態の管理にも対応し、ユーザー認証が必要な情報の取得も可能です。PHP 7.0以上に対応し、MITライセンスで公開されているため、オープンソースの音楽アプリ開発やサービス連携に最適なツールです。

GitHub

リポジトリの統計情報

  • スター数: 3
  • フォーク数: 0
  • ウォッチャー数: 3
  • コミット数: 5
  • ファイル数: 10
  • メインの言語: PHP

主な特徴

  • 多様な音質(標準、高品質、無損失、Hi-Res)での音楽再生リンクを取得可能
  • 楽曲検索や歌詞(通常、翻訳、ローマ字)取得に対応
  • プレイリストやアルバムの詳細情報と収録楽曲リストを取得可能
  • クッキーによるログイン状態管理をサポートし、認証が必要な情報も取得可能

技術的なポイント

本ライブラリはPHP 7.0以上を対象に設計されており、网易云音乐が公式に公開していないAPIへのアクセスを解析し、利用しやすい形で機能を提供しています。主にHTTPリクエストを送信し、JSON形式のレスポンスを解析して各種情報を抽出する仕組みです。

音楽再生リンクの取得は特に注目すべき機能で、网易云音乐の複数の音質に対応しています。標準音質からハイレゾ音質まで選択可能で、ユーザーのニーズに応じて柔軟に使い分けられます。これは、音楽配信サービスのAPIを利用するうえで高音質対応が求められる昨今において重要なポイントです。

また、歌詞取得機能は通常の歌詞だけでなく、翻訳された歌詞やローマ字表記の歌詞も取得できるため、多言語対応やカラオケ用途などにも便利です。これらはAPIからのレスポンス内に含まれる複数の歌詞タイプを適切にパースし、提供しています。

検索機能はキーワードによる楽曲検索をサポートし、関連する楽曲リストをAPI経由で取得可能です。これにより、ユーザーの好みに合わせた音楽推薦システムや検索機能を自作する際に役立ちます。

プレイリストやアルバム情報の取得では、プレイリストの詳細情報や収録楽曲リスト、アルバムの詳細と収録楽曲をまとめて取得できるため、UIでの表示やデータベースへの格納が容易です。

クッキーサポートを備えているのも特徴で、网易云音乐のログイン状態を維持し、認証が必要なAPIエンドポイントにアクセスできるため、より充実したユーザー情報や限定コンテンツの取得が可能となります。

内部構造はシンプルながら堅牢で、READMEに記載された使い方に従い、簡単にAPI呼び出しが可能です。MITライセンスのもと公開されているため、商用利用も含めて自由に活用できます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • LICENSE: ライセンスファイル(MITライセンス)
  • README.md: プロジェクトの概要と使い方を記載
  • cookie.txt: ログイン状態管理用のクッキーファイル
  • getAlbumDetail.php: アルバム情報を取得するサンプルスクリプト
  • getLyric.php: 歌詞取得のサンプルスクリプト

その他5ファイルには楽曲詳細取得、音楽再生リンク取得、検索機能などの実装が含まれています。

まとめ

网易云音乐のAPIをPHPで手軽に利用可能にする実用的ライブラリ。

リポジトリ情報: