Skip to content

Latest commit

 

History

History
119 lines (102 loc) · 6.11 KB

README.md

File metadata and controls

119 lines (102 loc) · 6.11 KB
Raw

image

Hatsune Miku's Neon World

A music visualizer web app built for the Hatsune Miku Magical Mirai 2023 programming competition.

Access it here: https://azn-abel.github.io/mikus-neon-world

日本語はこちら

Developers: Abel Lu, Christopher Lee, Luke Sbityakov
Artist: Anjolie Baccay

Notes

  • This application is optimized for landscape display on tablets and personal computers. The app will work on phones and smaller devices, but you may encounter some issues related to small screen size and native hardware.
  • Disclaimer: the source code for this project should NOT be used as a model/foundation for similar applications, as the project was severely rushed. The app works just fine, but we didn't focus on code quality and best practices as much as we'd wanted to.

Table of Contents

Features

  • Song Compatibility
    • Compatible with all six songs presented to competitors.
  • Music Visualization
    • Glowing animations that match the intensity of the songs, including six glowing bars representing the six songs featured.
  • Custom Artwork
    • Features a custom digital drawing of Hatsune Miku in this year's outfit, as well as custom assets used to create an elaborate backdrop
  • User Freedom
    • Users are given options to customize the experience to make it their own. This includes enabling/disabling certain animations and changing the scene colors.
  • Miku on Top of the World
    • As reference to her song: World is Mine, Miku is depicted on top of a skyscraper, broadcasting her voice into the night sky.

User Guide

  • How to access
  • How to use
    • Click the Play button to start listening!
    • Volume and visual-related settings can be found by clicking the gear icon
    • To switch songs, click the music notes icon

Build and Deploy

  • Building and Serving Locally
    • Clone the deploy branch of the repository.
    • You can use server extensions to serve the application on a local HTTP server.
      • VSCode: Live Server
        • Download "Live Server" extension
        • Right-click on index.html and select "Open with Live Server"
      • WebStorm: Built-In Preview
        • Right-click on the index.html file
        • Hover over "Open In"
        • Hover over "Browser", and select your desired browser
  • Deployment

初音ミクのネオン世界

ただの大学生が初音ミクの「マジカルミライ２０２３」のために作った音楽ビジュアライザです

デベロッパー： Abel Lu, Christopher Lee, Luke Sbityakov
イラストレーター: Anjolie Baccay

注意

このアプリは横向きのパソコンやタブレットで利用されるつもりでオプトマイズしました。スマホでも使えるんですが、画面のサイズに関する問題が出る可能性があります。

目次

機能

  • 曲の選択肢
    • このコンテストの６曲を全部使える
  • 音楽の見える化
    • ６曲を表す音楽の強度に合わせて明かる6本のビートバー
  • カスタムイラスト
    • 今年の衣装を着てる初音ミクのイラストとカスタムアセットで作った美しい背景
  • 自由に使える
    • ユーザーは自由に使えるためのオプションが付いてる。例えばアニメーションをエネーブルやディセーブルしたり、シーンの色を変えたりすることはできる
  • 初音ミクは世界で一番！
    • 「ワールドイズマイン」っていう曲の歌詞みたいにミクがスカイスクレーパーの屋根の上で夜空に声を響かす

ユーザーガイド

  • アクセスする方法
  • 使い方
    • プレイボタンをクリックして音楽を開始する！
    • ギアアイコンをクリックして音量とビジュアルに関する設定を変える
    • ノートアイコンをクリックして曲の変化できる

ビルドとデプロイ

  • ローカルでビルドとサーブ
    • レポジトリをクローンする (deployブランチ)
    • サーバー拡張部分でローカルのHTTPサーバーでアプリをサーブできる
      • VSCode: Live Server
        • 「Live Server」っていう拡張部分をダウンロードする
        • index.htmlを右クリックして「Open with Live Server」を選択する
      • WebStorm: 作り付けプレビュー
        • index.htmlを右クリックする
        • 「このアプリケーションで開く」にマウスを合わせる
        • 「ブラウザー」にマウスを合わせてブラウザーを選択する
  • デプロイ