← tak48dev

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

1
試合を設定する
設定画面でイベント名・チーム名・セット数・セット時間を入力し「試合開始」をタップ。
2
イベントを記録する
試合画面のボタン(シュート・ターンオーバー・罰則・メモ)をタップ。詳細を入力して「記録する」を押す。背番号は1〜99で入力(未入力は0として記録)。
3
タイマーを管理する
▶ボタンで開始・停止。±10sボタンでクイック調整。調整アイコンから分・秒を直接指定できます。
4
セットを切り替える
タイマーが終了するとダイアログが表示されます。「次のセットへ」でセット切替、「オーバータイムイベントを追加」でそのまま記録継続が可能です。イベント入力中にタイマーが終了した場合は、シートを閉じた後にダイアログが表示されます。
5
試合を終了する
タイマー終了時に「試合を終了」を選択、または左上の「終了」ボタンから手動終了。記録は自動保存されます。
6
スタッツを確認する
履歴画面で試合を選択し「スタッツ」タブを開く。セット別切替・右上カメラアイコンでキャプチャ共有が可能。
1
Set Up the Match
Enter event name, team names, sets, and duration, then tap Start Match.
2
Log Events
Tap a button (Shoot, Turnover, Penalty, Memo), fill in details including jersey number (1–99; blank records as 0), and press Record.
3
Manage the Timer
Use ▶ to start/stop. ±10s buttons for quick adjustment. Tap the slider icon for precise minute/second input.
4
Switch Sets
A dialog appears when the timer expires. Choose Next Set to continue, or Add Overtime Events to keep recording. If a sheet is open when the timer ends, the dialog appears after the sheet is dismissed.
5
End the Match
Select End Match from the timer-expiry dialog, or tap End in the top-left at any time. Data is saved automatically.
6
Review Statistics
Open History, select a match, and tap the Stats tab. Switch sets with the picker. Tap the camera icon to capture and share.

04

画面説明Screen Guide

画面内容
設定画面イベント名・チーム名・セット数・セット時間を設定します。
試合画面タイマー・スコアボード・クイックイベントボタン。左上「終了」で手動終了。
イベント入力シュート/ターンオーバー/罰則/メモの詳細と背番号を入力するモーダル画面。
イベントログ記録済みイベントを時系列で確認・削除。
スタッツ画面詳細スタッツ。セット別切替・GKグラフ・ポジションマップを含む。
履歴画面過去の試合一覧。スワイプでCSV出力・削除。メニューで一括操作・インポート。
ScreenDescription
SetupConfigure event name, team names, sets, and duration.
MatchTimer, scoreboard, and quick-event buttons. Tap End (top-left) to finish manually.
Event InputModal for entering shot, turnover, penalty, or memo details, plus jersey number.
Event LogReview or delete recorded events in chronological order.
StatsDetailed stats including GK charts, position map, and per-set switching.
HistoryAll 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 "========".

[Match Info] Home Team, Away Team, Home Score, Away Score, Periods, Period Duration (min), Date [Event Log] Period, Time, Team, Event, Shot Type, Position, Result, Turnover Type, Penalty Type, Jersey #

Column Details

ColumnValues
Shot TypeDistance / Cut-In / Wing / Post / Fast Break / Penalty / Empty
Shots only
PositionLW / L / C / R / RW / 7M / GK
Shots only
ResultGoal / Wide / Save
Shots only
Turnover TypePass / Catch / Line / Double / Over Steps / Charging / Kick / Passive / Other
Turnovers only
Penalty TypeYellow 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
Import adds new records — it does not overwrite existing data.

09

広告とプレミアムプランAds & Premium Plan

無料版ではホーム画面下部にバナー広告、スタッツ閲覧時にインタースティシャル広告(全画面)が表示されます。

広告削除(プレミアムプラン)¥400・買い切り
  • 設定画面の「広告を削除する」ボタン → プレミアムプラン画面から購入
  • 購入後はすべての広告が非表示になります
  • 同一 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.

Remove Ads (Premium Plan) — ¥400, one-time
  • 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

· 記録データはiPhone内に保存されます。アプリを削除するとデータも消去されます。
· 試合中にアプリがバックグラウンドに移るとタイマーが停止する場合があります。
· スタッツキャプチャにはポジションマップ(コート画像)は含まれません。
· イベント入力中にタイマーが終了した場合、シートを閉じた後にセット切替ダイアログが表示されます。
· All data is stored on your iPhone. Deleting the app erases all records.
· 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.