tak48dev · Handball Score for iPhone
使用
説明書User
Manual
01
アプリ概要Overview
ハンドボールの試合をリアルタイムで記録・分析できるiPhone専用アプリです。シュート・ターンオーバー・罰則などをタップで素早く記録し、試合後に詳細なスタッツを自動集計します。無料版では広告が表示されます。広告削除はアプリ内購入(買い切り)で対応しています。
Handball Score is an iPhone app for recording and analyzing handball matches in real time. Log shots, turnovers, and penalties with a single tap, then review detailed automatic statistics after the game. The free version includes ads. An in-app purchase (one-time) is available to remove all ads.
02
主な機能Key Features
試合設定
- ホーム/アウェイのチーム名・セット数(1〜2)・セット時間(最大30分)を設定
- 前回の入力値を自動保存
イベント記録
- シュート — タイプ(ディスタンス/カットイン/ウィング/ポスト/速攻/ペナルティ/エンプティ)・ポジション(LW/L/C/R/RW/7M/GK)・結果(ゴール/ゴール外/セーブ)・背番号
- ターンオーバー — パス・キャッチ・ライン・ダブル・オーバー・チャージング・キック・パッシブ・その他・背番号
- 罰則 — イエローカード・2分退場・レッドカード・背番号
- メモ — 自由記述
スタッツ分析
- シュート成功率・ターンオーバー率
- タイプ別シュート(7種類の集計表)
- シュートミス内訳(ゴール外/セーブ比率バー)
- ポジション別シュート(LW/L/C/R/RW/7M/GK の積み上げバー)
- 選手(背番号)別シュート成功率・ターンオーバー数
- カード・退場集計
- GKスタッツ — セーブ率・シュート阻止率
- GKセーブ率/阻止率の時間推移グラフ(ホーム・アウェイ別パネル)
- ランニングスコアグラフ
- ポジションマップ(コート図上にデータ表示)
- セット別スタッツ切替
データ管理
- 全試合の履歴を自動保存(SwiftData)
- 試合をスワイプしてCSV出力・削除
- 複数試合の一括選択・削除・CSVエクスポート
- CSVインポート(エクスポートしたファイルを読み込んで復元)
- スタッツのスクリーンキャプチャ共有
Match Setup
- Set home/away team names, number of sets (1–2), and set duration (up to 30 min)
- Previous entries are saved automatically
Event Logging
- Shot — Type (Distance / Cut-In / Wing / Post / Fast Break / Penalty / Empty Goal) · Position (LW/L/C/R/RW/7M/GK) · Result (Goal / Wide / Save) · Jersey number
- Turnover — Pass, Catch, Line, Double, Over Steps, Charging, Kick, Passive, Other · Jersey number
- Penalty — Yellow Card, 2-Min Suspension, Red Card · Jersey number
- Memo — Free text note
Statistics
- Shot success rate and turnover rate
- Shots by type — table for all 7 shot types
- Shot miss breakdown — Wide vs. Save ratio bar
- Shots by position — stacked bar for LW/L/C/R/RW/7M/GK
- Shots by player (jersey #) — success rate and turnover count
- Cards & suspensions totals
- GK stats — save rate and block rate
- GK save/block rate timeline (separate panels for home and away)
- Running score chart
- Position map overlay on court diagram
- Switch between total and per-set stats
Data Management
- All match records saved automatically (SwiftData)
- Swipe a match row to export CSV or delete
- Bulk select, delete, or CSV export across multiple matches
- CSV import — restore match data from a previously exported file
- Share stats as a full-page screenshot
03
基本的な使い方How to Use
04
画面説明Screen Guide
| 画面 | 内容 |
|---|---|
| 設定画面 | イベント名・チーム名・セット数・セット時間を設定します。 |
| 試合画面 | タイマー・スコアボード・クイックイベントボタン。左上「終了」で手動終了。 |
| イベント入力 | シュート/ターンオーバー/罰則/メモの詳細と背番号を入力するモーダル画面。 |
| イベントログ | 記録済みイベントを時系列で確認・削除。 |
| スタッツ画面 | 詳細スタッツ。セット別切替・GKグラフ・ポジションマップを含む。 |
| 履歴画面 | 過去の試合一覧。スワイプでCSV出力・削除。メニューで一括操作・インポート。 |
| Screen | Description |
|---|---|
| Setup | Configure event name, team names, sets, and duration. |
| Match | Timer, scoreboard, and quick-event buttons. Tap End (top-left) to finish manually. |
| Event Input | Modal for entering shot, turnover, penalty, or memo details, plus jersey number. |
| Event Log | Review or delete recorded events in chronological order. |
| Stats | Detailed stats including GK charts, position map, and per-set switching. |
| History | All past matches. Swipe to export CSV or delete. Use … menu for bulk actions and import. |
05
タイマー調整Timer Adjustment
試合画面のスライダーアイコンをタップするとモーダルが表示されます。
- クイック調整 — ±5s / ±10s / ±30s / ±60s ボタンで素早く調整
- 直接入力 — 分・秒のピッカーで正確に設定(上限はセット時間)
Tap the slider icon next to the timer to open the adjustment modal.
- Quick Adjust — ±5s / ±10s / ±30s / ±60s buttons
- Manual Input — set exact minutes and seconds via picker (capped at set duration)
06
イベントの削除Deleting Events
試合画面右上のリストアイコン → イベントログタブから、ゴミ箱アイコンで個別削除できます。ゴールを削除すると得点も自動的に取り消されます。
Tap the list icon (top-right of match screen) → Event Log tab → trash icon to delete an event. Deleting a goal automatically removes the score.
07
スタッツ詳細Stats Details
GKスタッツ
- セーブ率 = セーブ数 ÷ (ゴール数 + セーブ数)
- シュート阻止率 = (ゴール外 + セーブ) ÷ 総シュート数
- 時間推移グラフ — 横軸は秒単位(ラベルは分表示)、実線=セーブ率・破線=阻止率。ホームとアウェイは別パネルで表示
選手別シュート
- 各背番号のゴール数/シュート数・成功率・ターンオーバー数を一覧表示
- 背番号0はイベント記録時に背番号未入力のデータ
GK Stats
- Save Rate = Saves ÷ (Goals + Saves)
- Block Rate = (Wide + Saves) ÷ Total Shots faced
- Timeline graph — x-axis in seconds (labeled in minutes), solid line = save rate, dashed = block rate. Home and away shown in separate panels.
Shots by Player
- Lists each jersey number's goals/shots, success rate, and turnover count
- Jersey #0 represents events logged without a jersey number
08
CSV エクスポート/インポートCSV Export / Import
エクスポート
- 個別出力 — 履歴画面で試合セルを左スワイプ → 「CSV」ボタン
- 一括出力 — 履歴画面右上「…」→「CSVエクスポート」→ 試合を選択 →「エクスポート」
ファイル構造
1試合につき以下の構造で出力されます。複数試合は「========」で区切られます。
カラム詳細
| カラム | 値 |
|---|---|
| シュートタイプ | ディスタンス/カットイン/ウィング/ポスト/速攻/ペナルティ/エンプティ シュート時のみ |
| ポジション | LW / L / C / R / RW / 7M / GK シュート時のみ |
| 結果 | ゴール / ゴール外 / セーブ シュート時のみ |
| ターンオーバータイプ | パス/キャッチ/ライン/ダブル/オーバー/チャージング/キック/パッシブ/その他 ターンオーバー時のみ |
| 罰則タイプ | イエローカード / 2分退場 / レッドカード 罰則時のみ |
| 背番号 | 0〜99の整数(未入力は0) 全イベント共通 |
インポート
- 履歴画面右上「…」→「CSVインポート」→ ファイルを選択
- Files アプリ・iCloud Drive・AirDropで受け取ったファイルに対応
- 複数試合が含まれるCSVも一括インポート可能
Export
- Individual — swipe left on a match row in History → CSV button
- Bulk — tap … (top-right of History) → Export CSV → select matches → Export
File Structure
Each match is exported with the structure below. Multiple matches are separated by "========".
Column Details
| Column | Values |
|---|---|
| Shot Type | Distance / Cut-In / Wing / Post / Fast Break / Penalty / Empty Shots only |
| Position | LW / L / C / R / RW / 7M / GK Shots only |
| Result | Goal / Wide / Save Shots only |
| Turnover Type | Pass / Catch / Line / Double / Over Steps / Charging / Kick / Passive / Other Turnovers only |
| Penalty Type | Yellow Card / 2-Min Suspension / Red Card Penalties only |
| Jersey # | 0–99 (blank recorded as 0) All events |
Import
- Tap … (top-right of History) → Import CSV → select a file
- Supports files from the Files app, iCloud Drive, or AirDrop
- Files containing multiple matches are imported all at once
09
広告とプレミアムプランAds & Premium Plan
無料版ではホーム画面下部にバナー広告、スタッツ閲覧時にインタースティシャル広告(全画面)が表示されます。
- 設定画面の「広告を削除する」ボタン → プレミアムプラン画面から購入
- 購入後はすべての広告が非表示になります
- 同一 Apple ID であれば機種変更後も「購入を復元する」から無料で引き継ぎできます
The free version shows a banner ad at the bottom of the home screen and an interstitial ad (full-screen) when opening match statistics.
- Tap "Remove Ads (¥400)" on the home screen → purchase from the Premium Plan screen
- All ads are hidden immediately after purchase
- Use "Restore Purchase" on any device with the same Apple ID at no charge
10
注意事項Notes
· 試合中にアプリがバックグラウンドに移るとタイマーが停止する場合があります。
· スタッツキャプチャにはポジションマップ(コート画像)は含まれません。
· イベント入力中にタイマーが終了した場合、シートを閉じた後にセット切替ダイアログが表示されます。
· The timer may pause when the app moves to the background.
· The position map is not included in the stats screenshot.
· If the timer expires while an input sheet is open, the set-change dialog appears after you dismiss the sheet.