musicLineアプリ開発日記

作曲を誰でも楽しく簡単に♪

【iOS】進捗報告 9 (3大作曲ダイアログ)

musicLine(iOS)についての進捗。
今回は作曲画面の3大ダイアログについて進捗を報告します。

曲設定ダイアログ

トラック選択ダイアログ

楽器選択ダイアログ


実装状況

カテゴリタイトル補足
View
Common
ダイアログ
アラートメッセージユーザーに通知するコメント
数字ピッカー数字(範囲制限)をポップアップダイアルで取得
項目ピッカー特定の値をポップアップのリスト項目で取得
HTMLテキストテキストスタイルを部分的に変えるため、HTML形式に対応したText
文字制限テキスト編集文字制限付きのTextField、制限文字数を超えは赤文字で閉じる時に切り捨て
全画面テキスト編集複数行のテキストを編集する時に、ポップアップ全画面でTextEditorとキーボード表示
FitScrollView閾値高さで スクロールありorなしを切り替える(画面に収まるときはScrollViewにしない)
Composition
ダイアログ
曲設定タイトル・テンポ、キー等の曲の設定
トラック選択編集トラックの変更・追加/削除、ボリュームやミュート等の設定
楽器選択トラックの使用楽器変更、楽器のランダム選択・選択リセット(iOS独自)
Composition
Changer
曲設定変更
テンポ変更送信MIDI信号の変更
拍子変更フレーズ外音符の削除、横スクロール位置を修正
キー変更送信MIDI Noの増減
鍵盤タイプ変更鍵盤Noに応じて全ての音符位置を修正、縦スクロール位置を修正
編集トラック変更ピアノ鍵盤のサンプラー変更
トラック設定変更トラック名・略称、トラック追加・複製・削除


全進捗マップを表示

カテゴリタイトル補足
View
Common
ダイアログ
アラートメッセージユーザーに通知するコメント
数字ピッカー数字(範囲制限)をポップアップダイアルで取得
項目ピッカー特定の値をポップアップのリスト項目で取得
HTMLテキストテキストスタイルを部分的に変えるため、HTML形式に対応したText
文字制限テキスト編集文字制限付きのTextField、制限文字数を超えは赤文字で閉じる時に切り捨て
全画面テキスト編集複数行のテキストを編集する時に、ポップアップ全画面でTextEditorとキーボード表示
FitScrollView閾値高さで スクロールありorなしを切り替える(画面に収まるときはScrollViewにしない)
Composition
UI配置
ガイド表示
ピアノ
スクロールエリア
小節番号
小節線
分割線拡大率によって間隔を変化
フレーズフレーズがないところはフレーズ作成ボタンを表示
ツールボタン 選択中のツールはツール色にハイライトする
メロディーライン ペンツールでの音符作成時の入力線
メロディー音符 音符の先頭にチョボをつける
リズム音符 ベース音符のみ下に表示
サンプルデータ 手入力したサンプルデータの音符を配置
連符連符は数字で表示、拡大率によって省略
ツールガイド(ペン)長さ編集しているリズム音符、伸ばした時の削る範囲音符移動時、移動先の音階をわかりやすくする
ツールガイド(指)移動中の音符影、矩形選択の枠
ツールガイド(消しゴム)削除範囲、和音のみの削除範囲
ツールガイド(フレーズ)フレーズ移動・伸縮のバー、選択範囲テキスト(iOS独自)
フレーズボタンフレーズボタンとサブボタンを配置、ツールに応じてアイコンを変更、画面拡大率に応じて縮小
フレーズタブツールに応じてアイコンを変更、拡大率に応じて縮小、スクロール状態に応じて移動
音符描画の高速化音符が多くても描画できる速さへ最適化
音符の編集状態選択や変更した時に枠線の色変更
音符音階メロディ音符に音階表示
再生バー曲を再生している時に、再生位置をバーで表示
再生ボタン曲を再生/停止を監視して、状態を変更、再生準備が遅い時はインジケーターを表示
再生速度の表示曲の再生速度を表示(iOS独自)
テスト音のガイド鳴っている音階に色をつける
Composition
ダイアログ
フレーズフレーズの作成・設定・挿入、フレーズの長さやリピート回数の設定
曲設定タイトル・テンポ、キー等の曲の設定
トラック選択編集トラックの変更・追加/削除、ボリュームやミュート等の設定
楽器選択トラックの使用楽器変更、楽器のランダム選択・選択リセット(iOS独自)
Community
(共通)
UI配置
コミュニティディスプレイとコントローラーを表示。縦持ちと横持ちのレイアウト。どのディスプレイ、コントローラーを使用するかは各コミュニティ画面で派生
カテゴリーリスト群カテゴリー選択、カテゴリーリストを表示。どのカテゴリーリストを表示するかは各コミュニティ画面で派生
ページスクロールリストを表示。スワイプでリスト項目を取得。どのリスト項目を使用するかは各カテゴリーで派生
曲リスト項目各コミュニティ画面で派生系を用意する
リレー曲リスト項目左右にスワイプで前後走者の曲を表示
その他リスト項目曲ID:検索で曲ID一覧を表示、ユーザー:ユーザー検索やいいねリスト等で表示
曲詳細曲の情報と貰ったコメントを表示、送るコメントを編集する
曲の情報曲のタイトル、作者、ランキング順位、タグ、ユーザーの反応等を表示
貰ったコメントテキストとOGP特殊コメントの装飾
ソングビジュア曲再生位置の変更と可視化。曲情報でトロフィー変更。リスト/詳細ボタンで切り替え。シンプルのみ実装でリリース後に追加予定。
カテゴリー選択カテゴリータブ表示。スクロール可能。選択表示。
ユーザーアイコンユーザー画像、プレミアムリングを表示。タップでユーザーページへ
プレイヤー曲の再生、いいね・お気に入り等のボタン。現在の状況を反映再生リスト追加ボタン
設定パネルレイアウト設定、ソングビジュア設定、楽器フィルタ リリース後に実装予定
Community
Square
コミュニティ広場
UI配置
ディスプレイ状況によりカテゴリー説明/ソングビジュアを切り替え。
カテゴリー説明広場カテゴリーの説明
コントローラーカテゴリーリスト群/曲詳細を切り替え
カテゴリーリスト群Squareのカテゴリーリストを切り替えるように派生
リスト項目カテゴリー別にリスト項目を派生(ランキングなら左にランク情報)。コンテスト項目はタップでコンテスト画面へ
イベント詳細コンテストの詳細情報の表示
絞り込み検索
Community
UserPage
ユーザーページ
UI配置
ディスプレイユーザープロフィールを表示。下へスワイプした時に隠れてヘッダーが表示されるように
ユーザープロフィールユーザー情報、紹介文、アクティビティログ等表示
ユーザー情報名前、アイコン、リンクリスト、フォロー欄、紹介文表示
リンクリスト外部リンク(X等)ボタンを並べる
フォロー欄フォロー、ミュート、通知ボタン
アクティビティログ活動レベル、投稿曲数やいいね数など表示
ヘッダー
コントローラーディスプレイに追従
カテゴリーリスト群UserPageのカテゴリーリストを切り替えるように派生
リスト項目開閉するプレイリスト項目を作成。
Community
Contest
コンテスト結果
UI配置
ディスプレイ状況によりコンテスト概要/ソングビジュアを切り替え。
コンテスト概要コンテストのテーマ、内容、提案者の表示
コントローラーカテゴリーリスト群/曲詳細を切り替え
カテゴリーリスト群Contestのカテゴリーリストを切り替えるように派生
リスト項目コンテストの順位や自分の投票数を表示するリスト項目に派生
Community
ダイアログ
リストダイアログいいね・お気に入りをしたユーザーリスト表示、曲を含む再生リストの表示
メッセージアラート通知するテキストを知らせる(DLした時や削除確認など)
プロフィール編集名前、アイコン、紹介文等を編集
プレイリスト詳細プレイリストのタイトル、説明、作者、コメント等を表示
プレイリスト編集タイトル、アイコン、曲リスト等を編集
コンテスト投票開催コンテスト曲の視聴と投票
MIDI詳細曲のテンポ、音符・トラック数、使用楽器等
Composition
Common
作曲共通
データ構造座標とサイズ、状態を保持する。レンダラーやコライダー、通知等のロジック
コンバーターDomainのデータ構造へ変換・逆変換
通知機構Modelに変更があった時に、Viewへ通知して再描画。変更状況を監視してキャッシュ
Changer
曲設定変更
テンポ変更送信MIDI信号の変更
拍子変更フレーズ外音符の削除、横スクロール位置を修正
キー変更送信MIDI Noの増減
鍵盤タイプ変更鍵盤Noに応じて全ての音符位置を修正、縦スクロール位置を修正
編集トラック変更ピアノ鍵盤のサンプラー変更
トラック設定変更トラック名・略称、トラック追加・複製・削除
FingerTool
指ツール
音符の編集
データ構造フレーズの音符を取得、基点と移動ベクトルを保持して移動する
音符の移動和音や連符は上下のみに制御
音符の影移動中に操作できているかわかりやすいように(iOS独自)
内外判定音符の移動をフレーズ内に留める
衝突判定移動する音符が他の音符に重なったときの挙動
タップ選択タップした音符の子音符も選択・解除
矩形選択囲った音符を選択
音符の入れ替えリズム音符のスライドで重なった音符と入れ替える(iOS独自)
和音の削除和音を移動した時に重なる時に削除する
連符に切り替えリズム音符タップで切り替え
PenTool
ペンツール
音符の作成
データ構造音符を作成・分割・統合、フレーズへ音符を追加する
音符の作成タップで音符を作成。分割線に合わせて長さを決定
音符列の作成スワイプに沿って複数の音符を作成。音階変わる時に音符分割
有無判定タップやスワイプした縦ラインに既に音符があるか判定
音符の移動音符が既にある場合は、作成ではなく移動。一定距離進むと移動終了
音符の分割リズム音符をタップした時、音符を分割、メロディ線に沿ってY位置を動かす
音符の統合2つのリズム音符の間をタップした場合、音符を統合
音符の伸縮リズム音符を左右にスワイプすることで音符の長さを伸縮、始点で分割なし(仕様変更)
音符の消滅音符の伸縮をした時に長さが0になると削除する(iOS独自)
領域差演算音符伸縮で他の音符に重なる時は差演算して他の音符長さを削る
サンプリング補間素早くスワイプしても音符が移動できるようにサンプリング間を補間する
細かい音符分割線内の細かな音符を移動する挙動
EraserTool
消しゴムツール
音符の削除
データ構造和音と連符の認識、フレーズから音符を削除する
音符の削除タップで音符を削除
和音・連符の削除和音・連符をタップで和音・連符のみを削除(iOS独自)
音符種別判定タップした音符が和音・連符・ルート音符なのか判定する
音符列の削除スワイプで指定する削除範囲内の複数の音符を削除。
和音列の削除リズム音符をスワイプで複数の和音のみを削除。(iOS独自)
休符に切り替えリズム音符タップで休符に切り替える
PhraseTool
フレーズツール
フレーズの編集
データ構造トラックのフレーズを取得・追加、削除、状態
フレーズの作成・挿入ダイアログで長さとリピートを設定 リピートフレーズは未実装
フレーズの選択2点タップで範囲選択、範囲ガイドタップで選択解除(仕様変更)
フレーズの移動左右スワイプで移動、移動は選択フレーズとスワイプ中のフレーズを含む
フレーズの伸縮サブ編集領域をスワイプした時にフレーズ長さを伸縮、長さ0で削除(iOS独自)
フレーズの貼り付け選択フレーズをコピー・ペースト、サブボタンかフレーズタブタップで挿入、選択解除
周囲有無判定作成する小節の近くにフレーズがあるかの判定、設定できる長さやリピート回数の制御
フレーズボタン・タブツールに応じてフレーズボタン、タブの処理を変更
フレーズの結合連続する2フレーズの接する小節線をタップで結合(iOS独自)
フレーズの分割フレーズをタップで分割(iOS独自)
StampTool
スタンプツール
モチーフの編集
Transform
画面移動
座標変換
画面を上下移動ピアノのスワイプにより
画面を左右移動 スクロールエリアのスワイプにより
画面を拡大・縮小ピンチアウト・インにより基点を画面中心に設定する
画面を拡大・縮小(軸指定)長押しからのドラッグ。ピアノでX軸方向、スクロールエリアでY軸方向
MIDI コンバーターCompositionからMIDIのデータ構造へ変換
曲の再生画面左からMIDI再生、Compositionのデータ構造から曲の再生、再生位置の同期
曲の再生(最初から)再生ボタン長押しで最初から再生 最初から再生されるが、画面は最初に移動しない
曲の再生(位置指定)スクロール領域をダブルタップでその位置から再生(iOS独自)
再生速度の変更ドラッグで曲の再生速度を変更(iOS独自)
再生処理の最適化曲に変更がない時はキャッシュを使う、変更通知とキャッシュの管理
Commnity
Common
コミュニティ
データ構造カテゴリ等の曲情報、いいねやお気に入り等のリスポンスを保持
CommunitySongPlayerコミュニティ用にラップした曲プレイヤー
CategoryListsカテゴリーリスト群のモデル。カテゴリー別にフェッチ/キャッシュ
ListInfoカテゴリーリストのモデル、リストのスクロール位置、フェッチするページ番号等
ContextCommunity共通のCommonContextと各画面のContextがある
UserActivityManagerユーザーのアクティビティ(いいね、ミュートユーザー、再生リスト、モチーフ登録、アクセス履歴等)を管理
Service
サービスモデル
ListItemFetcherカテゴリーリスト項目のMLサーバーから取得する
MidiRepositoryMIDIファイルをサーバーから取得して貯める
UserActivityFetcherユーザーの行動をMLサーバーから取得する(再生数、再生リストに含まれているか、コメント等)
MIDI
Common
MIDI共通
データ構造MIDIフォーマットへ出力できる構造
コントローラー曲の読み込みや再生、再生位置の監視や音源の変更などMIDIの扱いを管理する
サンプラーピアノや音符生成時に単体のMidiイベントから音を鳴らす
Service
サービスモデル
MidiPlayerMIDIを再生する
MidiReaderMIDIファイルの読み込み
MidiWriterMIDIファイル出力
Account
Common
アカウント
データ構造ログインできる構造、アカウント情報、ログイン情報、MLユーザー情報
AccountManagerアカウントの管理、ログイン時にMLサーバーと通信
Service
サービスモデル
UserActivityRepositoryユーザーのアクティビティ(いいね、ミュートユーザー、再生リスト、モチーフ登録、アクセス履歴等)を貯める
ServerCommunicationMLサーバーと通信する処理を集約
Domain
データ構造
Json形式
Melody MelodyTrack, MelodyPhrase, NoteContainer, NoteBlock, Note
Drum DrumTrack, DrumPhrase, BeatContainer, Beat
通化 Original, Repeat, Syncの3種のPhraseをジェネリッククラスとプロトコルで抽象化
Service
サービスモデル
SongRederJsonファイルを読み込み、Domainのデータへ変換
SongWriterDomainのデータからJsonファイルへ書き出し
Common
Service
サービスモデル
リポジトリ保存データを管理


実装の詳細

曲設定ダイアログ

以下の曲設定を変更します。

  • タイトル
  • テンポ
  • 拍子
  • キー
  • 鍵盤種別

曲設定ダイアログ

曲設定の変更時に、変更した音を確認できるように曲を再生します。
設定変更時にトラック毎に保持しているMIDIキャッシュを全てクリアします。


拍子の変更

拍子変更で、1小節の拍数と1拍の長さを設定するため、小節長さが変わります。
小節長さが短くなる時、フレーズ外に出た音符を削除します。また、音符がフレーズの境目にある時、フレーズ外に出ないように音符長さを短くします。

変更前 4/4
変更後 2/4

なお小節長さを変更すると、横スクロール位置がズレてしまうので、現在の小節位置を維持するように位置を修正します。

また小節長さが短くなる時、フレーズ外の音符を削除して良いかアラートで知らせます。
(今後UNDO/REDO機能が実装されても元に戻せない処理)

変更時アラート


鍵盤種別の変更

鍵盤の変更に応じて、音符のY位置を変更します。
黒鍵盤を挿入する際は音階の変更はありませんが、ツール編集の都合で下からの鍵盤インデックスで保持しているため、音符Y位置の変更が必要です。

黒鍵盤OFF
黒鍵盤ON

なお鍵盤数が変わると、縦スクロール位置がズレてしまうので、画面中心の鍵盤位置を維持するように位置を修正します。

黒鍵盤を除去する場合は、黒鍵盤の音階が変わってしまうため、アラートで知らせます。

変更時アラート

ちなみに、黒鍵盤ON/OFFではピアノの見た目が変わります。OFFの場合は黒鍵盤を使わないので目立たないようにしてます。



トラック 選択/設定 ダイアログ

トラック一覧を表示し、編集するトラックを選択します。
編集トラック選択時に、ピアノ鍵盤のサンプラーをトラックの使用楽器へ変更します。

このダイアログで新しいトラックを追加/複製、削除も行います。
また、以下のトラック設定を変更できます。

  • ボリューム
  • ミュート設定
  • 可視設定
  • トラック名/略称
  • メモ
  • 使用楽器

トラック選択/設定ダイアログ


トラックの音符色

編集トラックの音符は青色ですが、背景トラックは音符色でわかるようにトラック毎に色が変わります。
なお、ミュートトラックは灰色で可視設定で非表示にすることもできます。

トラックの音符色

乗算ブレンディング 背景トラックの描画ブレンドには乗算を使用しています。
重なった部分を見せるために、半透明にしてアルファブレンドすることが一般的ですが、半透明だと重ならないときが見えづらくなるので、乗算ブレンドにしています。
乗算ブレンドでは重なったときのみ色が変わるため、編集トラックの音符よりも目立たないような薄い色を使用している場合に有効です。



楽器選択ダイアログ

トラックの使用楽器を選択します。
ダイアログ開く際に、現在使用している楽器にスクロールします。またカテゴリーを変更する時には、リストの先頭へスクロールします。

楽器選択ダイアログ

楽器選択時に変更した楽器で曲を再生します。
選択した楽器をもう一度タップするとダイアログを閉じます。


ランダム・リセットボタン(iOS独自)

カテゴリーの最後にランダムボタンとリセットボタンを追加しました。
楽器選びに迷った時はランダムボタンで楽器をランダムに選択します。思いもよらぬ曲ができるかも!?
楽器選択で迷ったけど元の楽器へ戻したい時はリセットボタンを使ってください。



他のダイアログ

アラートメッセージ

ユーザーにコメントを通知して、判断を仰ぐダイアログです。
ボタンの数は1, 2, 3と変更でき、選択肢を選ぶことができます。
汎用的に使用できるように、モデルから表示要求して選択肢に応じてコールバックするように作りました。

アラートメッセージ

数字ピッカー

テキストをタップした時にポップアップで数字ダイアログを表示します。
数字の範囲を決めれますが、ステップは1固定です。

数字ピッカー

項目ピッカー

テキストをタップした時に、テキストの下にポップアップでリストを表示します。
リスト項目は数字に限らず、@Bindingで選択した値を取得します。

項目ピッカー

HTMLテキスト

部分的にテキストスタイルを変更できる、HTML形式に対応したTextです。

TextWithHTML("fps : <font size='+5' color='red'>30</font>", defultColor: .blue)

HTMLテキスト

文字制限テキスト編集

文字数制限を設定できるTextFieldです。
制限文字数を超える時は赤文字になります。なお赤文字のままダイアログを閉じると切り捨てになります。

文字制限テキスト編集

全画面テキスト編集

テキストをタップした時に、ポップアップで全体にTextEditorとキーボードを表示します。複数行のテキストを編集する時に、他に余計な項目があると邪魔だったりするので実装しました。

また文字数制限の設定もでき、制限数を超えた時は決定ができなくしてます。

全画面テキスト編集
文字数制限を超えた時
曲再生時の挙動

曲の再生中は鳴っている音階の鍵盤に色をつけます。

鳴っている鍵盤に色

曲再生中に音符・フレーズに変更があれば、色がつきます。
再生中の変更はすぐに音に反映されず、再度再生した時に変更が反映されます。

再生中の音符色



おわりに

作曲で主に使うダイアログ3種はスムーズに実装できましたー^ ^
特に編集トラックの変更は、意味不明な不具合が出るんだろうなと意気込んでましたが、意外と最小限の修正に収まることが出来ました!!
さらに数字ピッカーや項目ピッカーなどは今後のダイアログ作りにも役立ちそうですᐠ( ᐢ ᵕ ᐢ )ᐟ

次からはドラムトラックを実装していきます。