Monaca Docs
  • Monaca とは
  • 最初のアプリを作る
  • アプリをテストする
  • Monaca リリース情報
    • iOS プライバシーマニフェスト対応
    • 「ニフクラ mobile backend」終了に関するお知らせ
    • プラグイン uses-permission タグの重複修正機能
    • Cordova 12 の変更点
    • iOSストア版Monaca デバッガー配信停止と代替機能のご案内
    • iOS App Store への送信エラー (ITMS-90165)
    • cordova-custom-configのビルドエラー
    • Cordova 11 の変更点
    • Cordova 10 の変更点
    • Cordova 9.0 の変更点
    • 利用規約の変更
    • 新しい Monaca CLI と Localkit
    • CordovaからCapacitorへの移行
  • Monacaガイド
    • Monaca での開発の概要
    • Monaca クラウド IDE
      • 概要
      • Monaca クラウド IDE の機能
      • ターミナル機能
      • エディターのショートカット一覧
      • プロジェクトの構成
        • ファイル・フォルダー構成
        • JS/CSS コンポーネント
        • Cordova プラグイン
        • ユーザー Cordova プラグイン
      • バージョン管理
        • 概要
        • GitHub との連携
        • Git SSH との連携
      • Monaca CI
        • 概要
        • アプリ配信 / 配布サービス (デプロイサービス)
        • Appetize.ioへの配信
        • DeployGateへの配信
        • Firebase への配信
      • ビルド
        • iOS アプリのビルド
          • iOS アプリのビルド
          • Monaca と Xcode 間でのビルド設定の再利用
        • Android アプリのビルド
        • Windows アプリのビルド
        • Electron アプリのビルド
          • Windows アプリのビルド
        • PWA アプリのビルド
        • ビルド環境の設定
        • ビルド履歴一覧
        • 一般的なビルドとアップロードエラー
      • 配布方法
        • App Store での配布
          • App Store Connect ガイド
          • iOS アプリ アップロード機能
        • Google Play での配布
        • 公式ストア経由以外での配布
      • パッケージダウンロード機能
      • チュートリアル
    • Monaca Localkit
      • 概要
      • ペアリングとデバッグ
      • リモートビルドと配布申請
      • トラブルシューティング
        • インストール ( Windows の場合 )
        • インストール ( Mac OS X の場合 )
        • アンインストール時 ( Windows の場合 )
        • 不完全なファイル・フォルダー構成
        • プレビューウィンドウが更新されない
        • Error while installing
        • nodeのインストールが必要です
      • チュートリアル
    • Monaca CLI
      • 概要
      • Monaca CLI コマンド
      • ペアリングとデバッグ
      • リモートビルドと配布申請
      • トラブルシューティング ガイド
      • チュートリアル
    • Monaca デバッガー
      • 機能の概要
      • インストール方法
        • Android 向けの Monaca デバッガー
        • iOS 向け Monaca デバッガー
        • Android エミュレーター向け Monaca デバッガー
      • 使用例
      • iOS カスタムビルド版デバッガー
      • iOS シミュレータービルド
      • トラブルシューティング ガイド
      • チュートリアル
    • チームダッシュボード
    • クイックビューア
    • 他のプラットフォームからの移行
      • 移行時の確認ポイント
      • クラウドIDE プレビュー機能の設定
      • Angular からの移行
      • Ionic からの移行
      • React からの移行
      • Vue からの移行
      • Telerik からの移行
  • 🛠️アプリビルド
    • iOS ビルド
      • 秘密鍵とCSRの作成
      • 証明書の作成
      • プロビジョニング・プロファイルの更新
  • チュートリアル
    • Monaca クラウド IDE チュートリアル
      • パート 1 : プロジェクトの作成
      • パート 2 : Monaca クラウド IDE と Monaca デバッガーとの連携
      • パート 3 : Monaca アプリのビルド
      • パート 4 : Monaca アプリの配布申請
    • Monaca Localkit チュートリアル
      • パート 1 : プロジェクトの作成
      • パート 2 : Monaca Localkit と Monaca デバッガーとの連携
      • パート 3 : Monaca アプリのビルド
      • パート 4 : Monaca アプリの配布申請
    • Monaca CLI チュートリアル
      • パート 1 : プロジェクトの作成
      • パート 2 : Monaca CLI と Monaca デバッガーとの連携
      • パート 3 : Monaca アプリのビルド
      • パート 4 : Monaca アプリの配布申請
    • Electron アプリ開発
      • NPMパッケージの利用方法
      • Web APIの利用方法
    • バーコードスキャナープラグイン
    • Cordova Sqlite Storage プラグイン
    • Cordova Google Analytics プラグイン
    • Cordova Firebase プラグイン
    • Cordova In-app Purchase プラグイン
    • Cordova AppVersion プラグイン
    • Cordova Ionic Keyboard プラグイン
    • Cordova Social Sharing プラグイン
    • Phonegap Push プラグイン
  • APIの解説
    • Monaca API
      • Monaca クラウド & リモートビルド API
      • ユーティリティ
    • 基本プラグイン
      • Cordova 12.0
        • Battery プラグイン
        • Camera プラグイン
        • Device プラグイン
        • Device Motion プラグイン
        • Device Orientation プラグイン
        • Dialog プラグイン
        • File プラグイン
        • Geolocation プラグイン
        • InAppBrowser プラグイン
        • Media プラグイン
        • Media Capture プラグイン
        • Network Information プラグイン
        • Vibration プラグイン
        • StatusBar プラグイン
      • Cordova 11.0
        • Battery プラグイン
        • Camera プラグイン
        • Device プラグイン
        • Device Motion プラグイン
        • Device Orientation プラグイン
        • Dialog プラグイン
        • File プラグイン
        • Geolocation プラグイン
        • InAppBrowser プラグイン
        • Media プラグイン
        • Media Capture プラグイン
        • Network Information プラグイン
        • Splashscreen プラグイン
        • Vibration プラグイン
        • StatusBar プラグイン
      • Cordova 10.0
        • Battery プラグイン
        • Camera プラグイン
        • Device プラグイン
        • Device Motion プラグイン
        • Device Orientation プラグイン
        • Dialog プラグイン
        • File プラグイン
        • Geolocation プラグイン
        • InAppBrowser プラグイン
        • Media プラグイン
        • Media Capture プラグイン
        • Network Information プラグイン
        • Splashscreen プラグイン
        • Vibration プラグイン
        • StatusBar プラグイン
        • Whitelist プラグイン ( Android 専用 )
      • Cordova 9.0
        • バッテリー情報の取得 プラグイン
        • カメラ操作 プラグイン
        • 住所録の取得 プラグイン
        • 端末情報の取得 プラグイン
        • 端末のモーション検知 プラグイン
        • 端末のオリエンテーション検知 プラグイン
        • ダイアログの制御 プラグイン
        • ファイル操作 プラグイン
        • ファイル転送 プラグイン
        • 位置情報の取得 プラグイン
        • 表記の国際化対応 プラグイン
        • InAppBrowser プラグイン
        • メディア操作 プラグイン
        • メディアキャプチャー プラグイン
        • ネットワーク情報の取得 プラグイン
        • スプラッシュスクリーンの制御 プラグイン
        • バイブレーションの制御 プラグイン
        • ステータスバーの制御 プラグイン
        • ホワイトリストへの登録 プラグイン ( Android 専用 )
    • サードパーティー製プラグイン
      • AdvancedHTTPプラグイン
      • PhoneGap BarcodeScanner
      • Custom Config
      • Datepicker
      • Share ( Android 向け )
      • WebIntent ( Android 向け )
    • Monaca 提供プラグイン
      • アプリロジック暗号化 (Encrypt プラグイン)
      • In-App アップデーター (In-App Updater)
      • セキュア ストレージ
      • NFC リーダー
      • バーコードスキャナー
      • Androidビルドメモリサイズ設定
    • 外部サービス連携
      • Repro
      • AppsFlyer
    • 設定ファイル
      • Android
        • Android の設定
        • config.xml
        • AndroidManifest.xml
      • iOS
        • iOS の設定
        • config.xml
        • MonacaApp-info.plist
  • サンプル & Tips
    • Firestoreを利用する
    • サンプルアプリ
      • Twitter アプリ
      • Facebook アプリ
      • 広告 アプリ (AdMob)
      • Hello World アプリ
      • メモ帳アプリ
      • ブロック崩しゲーム
      • Flickrアプリ
      • TODO管理 アプリ
      • 電車図鑑アプリ
      • 時計アプリ
      • 誕生年の計算アプリ
      • おみくじ占いアプリ
      • RSS リーダーアプリ
    • 開発 Tips
      • 音楽の再生方法
      • スプラッシュ画像の制御方法
      • データベースの利用方法
  • Webpack5への更新
  • 機能
    • SNS 認証
    • プッシュ通知
    • データベース
  • 外部サービス連携ガイド
    • Firebase
      • アプリの登録と設定ファイルの取得
  • 移行ガイド
    • ニフクラ mobile backend
      • プッシュ通知
        • Firebaseサービスの設定
        • ソースコードの移行
      • データストア
        • ソースコードの移行
        • データの移行
        • データ移行スクリプト実行手順
      • 会員管理・認証
        • 会員管理 データの移行
        • Firebase Authentication パスワード再設定サンプル
        • Firebase Authenticationを使用したユーザー名認証の方法
      • スクリプト
        • Firebase Functions開発環境の作成
        • サンプル共通項目
        • サンプル1(GETサンプル)
        • サンプル2(POSTサンプル)
        • サンプル3(DELETEサンプル)
        • エミュレータでのテスト
      • ファイルストア
        • ファイルアップロード
        • ファイル検索
        • ファイル一覧表示
        • ファイル削除
  • FAQ
    • 概要
    • IDE
    • ビルド
    • リリース
    • 契約プラン
    • アプリケーション
    • 使用方法
    • Freeプラン
    • デバッガー
  • 対応環境
  • トラブルシューティング
    • プレビューログがリロードを繰り返す (Vue packages version mismatch error)
  • Monaca製品サイト
  • 運営会社
  • English
GitBook提供
このページ内
  • 廃止通知
  • プラグイン ID
  • プラグインの追加方法 ( Monaca 上での処理 )
  • 後方互換
  • iOS 特有の動作
  • API の解説
  • navigator.contacts
  • navigator.contacts.create
  • navigator.contacts.find
  • navigator.contacts.pickContact
  • Contact
  • ContactAddress
  • ContactError
  • ContactField
  • ContactName
  • ContactOrganization
  • ContactFieldType

役に立ちましたか?

  1. APIの解説
  2. 基本プラグイン
  3. Cordova 9.0

住所録の取得 プラグイン

前へカメラ操作 プラグイン次へ端末情報の取得 プラグイン

最終更新 3 年前

役に立ちましたか?

非推奨プラグイン (Cordova 9.0 以降)

テスト環境 ( バージョン番号 ) :

このプラグインの詳細は、 をご確認ください。

このプラグインでは、グローバルオブジェクト 「 navigator.contacts 」 を使用し、端末側の住所録のデータベースにアクセスします。

このオブジェクトは、グローバルスコープ ( navigator ) に属していますが、使用できるのは、deviceready イベントの発火後になります。

document.addEventListener("deviceready", onDeviceReady, false);
    function onDeviceReady() {
    console.log(navigator.contacts);
}

住所録データの取得・利用には、個人情報保護の観点から、細心の注意が必要です。住所録データの取り扱い方法と第三者への情報提供に関しては、個人情報の取り扱いポリシーの策定時に議論されるべき問題です。個人情報の中でも、とりわけ住所録の情報は、交友関係などの個人のプライバシーに深く関わることから、その取り扱いには、特に注意が求められます。そのため、アプリのプライバシーに関するポリシーの策定に加え、アプリが住所録にアクセスまたは利用する場合には、事前にユーザーへの通知および許諾を得る必要があります。端末のオペレーティング システム側でこの通知および許諾の要求を行ってない場合には、開発者側で改善する必要があります。また、ユーザーへの通知および許諾の要求を行う場合には、必ず、個人情報の取り扱いに関するポリシーの開示および使用方法に関する同意の意思表示を求める必要があります ( 許可する、または、許可しない のように、明示的に判断できる必要があります )。また、住所録へアクセスする前に、ユーザーへの通知および許諾を得ることを配布の条件とする、アプリのマーケットプレースも一部に存在します。住所録データの取り扱いの説明に関しては、ユーザーの不安や困惑を取り除くため、内容を明快に理解できるよう、考慮が求められます。詳細は、をご確認ください。

廃止通知

このプラグインは廃止予定です。 このプラグインは、Cordova 開発コミュニティによって、これ以上の作業は行われません。このプラグインは引き続き使用できますが、問題が発生しても Cordova 開発コミュニティでの修正は行われません。

プラグイン ID

cordova-plugin-contacts

プラグインの追加方法 ( Monaca 上での処理 )

後方互換

iOS 特有の動作

iOS 10以降、プライバシーに関連するデータにアクセスする場合は、 info.plist に使用の説明を設定することが必須になります。アクセスを許可するようにシステムに指示すると、この使用の説明はアクセス許可ダイアログボックスの一部として表示されますが、使用の説明を入力しない場合は、ダイアログが表示される前にアプリが強制終了します。また、Apple は個人データにアクセスするアプリをリジェクトしますが、使用の説明は提供していません。

このプラグインでは、次の使用の説明が必要になります。

  • NSContactsUsageDescription では、アプリがユーザーの連絡先にアクセスする理由を記述します。

これらの設定を info.plist に追加するには、config.xml ファイルの <edit-config> タグに以下のように設定します。

<edit-config target="NSContactsUsageDescription" file="*-Info.plist" mode="merge">
    <string>need contacts access to search friends</string>
</edit-config>

API の解説

navigator.contacts

メソッド

  • navigator.contacts.create

  • navigator.contacts.find

  • navigator.contacts.pickContact

オブジェクト

  • Contact

  • ContactName

  • ContactField

  • ContactAddress

  • ContactOrganization

  • ContactFindOptions

  • ContactError

  • ContactFieldType

navigator.contacts.create

navigator.contacts.create メソッドは、同期的に処理され、Contact オブジェクトを返します。このメソッドは、連絡先オブジェクトを端末の連絡先データベースに保持しません。保持したい場合は、Contact.save メソッドを呼び出す必要があります。

サポート対象のプラットフォーム

  • Android

  • iOS

例

var myContact = navigator.contacts.create({"displayName": "Test User"});

navigator.contacts.find

navigator.contacts.find メソッドは、非同期的に実行され、住所録データベースへの問い合わせ、および、その結果として、 Contact オブジェクト群を配列に入れ、返します。また、その返ってきたオブジェクトは、*contactSuccess* パラメーターに指定されている contactSuccess コールバック関数に渡されます。

contactFields パラメーターを使用して、検索時に使用する検索項目を指定します。*contactFields* のパラメーターに、空の文字列を使用することはできません。また、その場合、結果として、ContactError.INVALID_ARGUMENT_ERROR が返ってきます。 contactFields の値に、 "*" を入力した場合、住所録のすべての項目を検索します。

住所録データベースへの問い合わせ時に、*contactFindOptions.filter* の文字列を使用すれば、結果を絞り込めます。この値を使用した場合、*contactFields* パラメーター で指定した項目に対して、追加の絞り込み条件 ( 大・小文字の区別なし、部分一致 ) が適用されます。指定した項目内で一致する 内容がある 場合には、その住所録を返します。また、 contactFindOptions.desiredFields パラメーターを使用すれば、返ってくる住所録のプロパティを指定できます。

contactFields と contactFindOptions.desiredFields の両方でサポートされる値は、ContactFieldType <6.5_contactfieldtype> オブジェクトで列挙されます。

パラメーター

  • contactFields: 検索時に使用する、住所録の検索項目です。 *(DOMString[])* [ 必須 ]

  • contactSuccess: 成功時のコールバックです。Contactオブジェクト群が入れられた配列( オブジェクトはデータベースから取得) が渡されます。 [ 必須 ]

  • contactError: 失敗時のコールバックです。エラー発生時に実行されます。 [ 任意 ]

  • contactFindOptions: navigator.contactsで使用する絞り込み検索オプション。 [任意]

    。使用するキーを以下に示します。

    • filter: 検索時に使用する文字列です。 (DOMString) (デフォルトでは \"\" )

    • multiple: 複数の navigator.contactsを、検索結果として返すようにするための真偽値を設定します。(Boolean) ( デフォルトでは false )

    • desiredFields: 返ってくる住所録の項目を指定します。指定した場合、結果とし返されるContactオブジェクトには、指定された項目の値のみ格納されています。(DOMString[]) [ 任意 ]

    • hasPhoneNumber( Android 専用 ) : 電話番号が入力されている住所録のみを、検索結果として返します。(Boolean) ( デフォルトでは false )

サポート対象のプラットフォーム

  • Android

  • iOS

例

function onSuccess(contacts) {
    alert('Found ' + contacts.length + ' contacts.');
};

function onError(contactError) {
    alert('onError!');
};

// find all contacts with 'Bob' in any name field
var options      = new ContactFindOptions();
options.filter   = "Bob";
options.multiple = true;
options.desiredFields = [navigator.contacts.fieldType.id];
options.hasPhoneNumber = true;
var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
navigator.contacts.find(fields, onSuccess, onError, options);

navigator.contacts.pickContact

navigator.contacts.pickContact メソッドを使用すると、住所録の一覧が表示され、その中から対象の住所録を選択できます。また、結果として返ってきたオブジェクトは、*contactSuccess* パラメーターに指定されている contactSuccess コールバック関数に渡されます。

パラメーター

  • contactSuccess: 成功時のコールバックです。Contact オブジェクトが1 つ渡されます。[ 必須 ]

  • contactError: 失敗時のコールバックです。エラー発生時に実行されます。 [ 任意 ]

サポート対象のプラットフォーム

  • Android

  • iOS

例

navigator.contacts.pickContact(function(contact){
    console.log('The following contact has been selected:' + JSON.stringify(contact));
},function(err){
    console.log('Error: ' + err);
});

Android 特有の動作

function onResume(resumeEvent) {
    if(resumeEvent.pendingResult) {
        if(resumeEvent.pendingResult.pluginStatus === "OK") {
            var contact = navigator.contacts.create(resumeEvent.pendingResult.result);
            successCallback(contact);
        } else {
            failCallback(resumeEvent.pendingResult.result);
        }
    }
}

Contact

Contact オブジェクトは、住所録の情報を処理するときに使用されます。住所録は、作成・保存・削除できます ( 端末側の住所録用のデータベース上 )。また、住所録は、navigator.contacts.find を使用して、データベース上で検索 ( retrieve、個々または一括で取得可 ) できます。

ここで紹介している住所録の項目は、一部のプラットフォームでは使用できません。各プラットフォームのサポート状況に関しては、各 *プラットフォーム特有の動作* の記載内容をご確認ください。

プロパティ

  • id: グローバルな一意の識別子です。 (DOMString)

  • displayName: Contact の名称です ( 各 Contact に設定)。ユーザーに対して表示する場合に使用できます。 (DOMString)

  • name: 個人の名に関する、すべての要素を格納するオブジェクトです。(ContactName)

  • nickname: 住所録で使用するニックネームです。 (DOMString)

  • phoneNumbers: 電話番号を格納する配列です。 (ContactField[])

  • emails: メールアドレスを格納する配列です。 (ContactField[])

  • addresses: 住所を格納する配列です。 (ContactAddress[])

  • ims: IM ( インスタント メッセンジャー )アドレスを格納する配列です。 (ContactField[])

  • organizations: 所属組織名を格納する配列です。(ContactOrganization[])

  • birthday: 誕生日です。 (Date)

  • note: メモ書きです。 (DOMString)

  • photos: 写真を格納する配列です。 (ContactField[])

  • categories: ユーザー定義のカテゴリーを格納する配列です。(ContactField[])

  • urls: Web ページのリンク先を格納する配列です。(ContactField[])

メソッド

  • clone: 呼び出し元 ( コピー元 ) のオブジェクトのディープコピー (deep copy ) である、新規の Contact オブジェクトを返します。idプロパティは null に設定されています。

  • remove:住所録データベースから、対象の住所録を削除します。削除が失敗した場合は、ContactErrorオブジェクトを使用して、失敗時のコールバック関数が呼び出されます。

  • save: 新しい住所録を、住所録データベースに保存します。同じid を持つ住所録が存在する場合には、既存の住所録を更新します。

サポート対象のプラットフォーム

  • Android

  • iOS

Save 例

function onSuccess(contact) {
    alert("Save Success");
};

function onError(contactError) {
    alert("Error = " + contactError.code);
};

// create a new contact object
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber";            // specify both to support all devices

// populate some fields
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;

// save to device
contact.save(onSuccess,onError);

Clone 例

// clone the contact object
var clone = contact.clone();
clone.name.givenName = "John";
console.log("Original contact name = " + contact.name.givenName);
console.log("Cloned contact name = " + clone.name.givenName);

Remove 例

function onSuccess() {
    alert("Removal Success");
};

function onError(contactError) {
    alert("Error = " + contactError.code);
};

// remove the contact from the device
contact.remove(onSuccess,onError);

保存した連絡先から電話番号を削除する例

// Example to create a contact with 3 phone numbers and then remove
// 2 phone numbers. This example is for illustrative purpose only
var myContact = navigator.contacts.create({"displayName": "Test User"});
var phoneNumbers = [];

phoneNumbers[0] = new ContactField('work', '768-555-1234', false);
phoneNumbers[1] = new ContactField('mobile', '999-555-5432', true); // preferred number
phoneNumbers[2] = new ContactField('home', '203-555-7890', false);

myContact.phoneNumbers = phoneNumbers;
myContact.save(function (contact_obj) {
    var contactObjToModify = contact_obj.clone();
    contact_obj.remove(function(){
        var phoneNumbers = [contactObjToModify.phoneNumbers[0]];
        contactObjToModify.phoneNumbers = phoneNumbers;
        contactObjToModify.save(function(c_obj){
            console.log("All Done");
        }, function(error){
            console.log("Not able to save the cloned object: " + error);
        });
    }, function(contactError) {
        console.log("Contact Remove Operation failed: " + contactError);
    });
});

Android 2.X 特有の動作

  • categories: Android 2.X端末では、このプロパティは使用できません。 null を返します。

iOS 特有の動作

  • displayName: iOS では使用できません。 ContactNameを指定しない場合、 null を返します。指定した場合、連結させた名前 (composite name )、*nickname*、"" のいづれかを返します。

  • birthday: JavaScript の Dateオブジェクトとして取り扱う必要があります ( 入力時・取得時の両方 )。

  • photos: アプリの tmp ディレクトリーに保存された画像を指す FileURL を返します。なお、tmpディレクトリーに置かれたコンテンツは、アプリを閉じたときに削除されます。

  • categories: 使用できません。 null を返します。

ContactAddress

ContactAddress オブジェクトを使用して、住所録中の 「 住所 」 に関連したプロパティ群を格納します。1 つの Contact オブジェクトには、ContactAddress[] の配列を使用して、複数の住所を格納できます。

プロパティ

  • pref: 最優先にする値を格納する ContactAddress であれば、trueに設定します。(boolean)

  • type: 項目のタイプを示した文字列です。例 : home ( 自宅用 )(DOMString)

  • formatted: 表示用の住所です。 (DOMString)

  • streetAddress: 番地です。 (DOMString)

  • locality: 市区町村です。 (DOMString)

  • region: 都道府県です。 (DOMString)

  • postalCode: 郵便番号です。 (DOMString)

  • country: 国です (DOMString)

サポート対象のプラットフォーム

  • Android

  • iOS

例

// display the address information for all contacts

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        for (var j = 0; j < contacts[i].addresses.length; j++) {
            alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
                "Type: "           + contacts[i].addresses[j].type          + "\n" +
                "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
                "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
                "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
                "Region: "         + contacts[i].addresses[j].region        + "\n" +
                "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
                "Country: "        + contacts[i].addresses[j].country);
        }
    }
};

function onError(contactError) {
    alert('onError!');
};

// find all contacts
var options = new ContactFindOptions();
options.filter = "";
options.multiple = true;
var filter = ["displayName", "addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);

Android 2.X 特有の動作

  • pref: Android 2.X 端末では使用できず、false を返します。

iOS 特有の動作

  • pref: iOS 端末では使用できず、false を返します。

  • formatted: 現在、使用できません。

ContactError

エラーの発生時には、contactError コールバック関数から、ContactError オブジェクトが返されます。

プロパティ

  • code: 次のエラーコードのいずれか

定数

  • ContactError.UNKNOWN_ERROR (code 0)

  • ContactError.INVALID_ARGUMENT_ERROR (code 1)

  • ContactError.TIMEOUT_ERROR (code 2)

  • ContactError.PENDING_OPERATION_ERROR (code 3)

  • ContactError.IO_ERROR (code 4)

  • ContactError.NOT_SUPPORTED_ERROR (code 5)

  • ContactError.OPERATION_CANCELLED_ERROR (code 6)

  • ContactError.PERMISSION_DENIED_ERROR (code 20)

ContactField

ContactField オブジェクトは、再利用可能で、汎用的なコンポーネントです。住所録の各項目の値を格納するために使用します。各 ContactField オブジェクトには、value、type、pref プロパティを 1 つずつ格納できます。ContactField[] の配列を使用して、電話番号・メールアドレスのような、複数登録する必要があるプロパティを格納します。

ContactField オブジェクトの type 属性に関しては、多くの場合、事前に定義された値はありません。*type* に設定する値として、たとえば、電話番号に関しては、*home*、*work*、*mobile*、 iPhone があります。または、特定のプラットフォームで使用されている住所録データベースがサポートしている、他の値も設定できます。ただし、Contact の photos 項目に関しては、*type* 属性を使用して、返される画像の形式を設定します。 value 属性に、写真の画像の URL を格納する場合には url を、Base64 形式の画像の文字列を格納する場合には base64 を設定します。

プロパティ

  • type: 項目のタイプを示した文字列です。例 : home ( 自宅用 )(DOMString)

  • value: 項目の値です。例 : 電話番号、*メールアドレス*(DOMString)

  • pref: 最優先にする値を格納する ContactField であれば、trueに設定します。 (boolean)

サポート対象のプラットフォーム

  • Android

  • iOS

例

// create a new contact
var contact = navigator.contacts.create();

// store contact phone numbers in ContactField[]
var phoneNumbers = [];
phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
contact.phoneNumbers = phoneNumbers;

// save the contact
contact.save();

Android 特有の動作

  • pref: 使用できません。 false を返します。

iOS 特有の動作

  • pref: 使用できません。 false を返します。

ContactName

Contact オブジェクトが保持する 「 名前 」 に関する、さまざまな情報を格納します。

プロパティ

  • formatted: フルネームです。 (DOMString)

  • familyName: 姓です。 (DOMString)

  • givenName: 名です。 (DOMString)

  • middleName: ミドルネームです。 (DOMString)

  • honorificPrefix: 接頭敬称です。例 : Mr. 、Dr. (DOMString)

  • honorificSuffix: 接尾敬称です。例 Esq. (DOMString)

サポート対象のプラットフォーム

  • Android

  • iOS

例

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
            "Family Name: "  + contacts[i].name.familyName      + "\n" +
            "Given Name: "   + contacts[i].name.givenName       + "\n" +
            "Middle Name: "  + contacts[i].name.middleName      + "\n" +
            "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
            "Prefix: "       + contacts[i].name.honorificSuffix);
    }
};

function onError(contactError) {
    alert('onError!');
};

var options = new ContactFindOptions();
options.filter = "";
options.multiple = true;
filter = ["displayName", "name"];
navigator.contacts.find(filter, onSuccess, onError, options);

Android 特有の動作

  • formatted: 部分的に使用できますが、読み取り専用です。honorificPrefix、givenName、middleName、familyName、honorificSuffixを連結して返します。

iOS 特有の動作

  • formatted: 部分的に使用できます。読み取り専用の iOS の連結名 (Composite Name ) を返します。

ContactOrganization

ContactOrganization オブジェクトを使用して、組織に関するプロパティを格納します。 Contact オブジェクトは、単数または複数の ContactOrganization オブジェクトを配列形式で保持します。

プロパティ

  • pref: 最優先にする値を格納する ContactOrganizationであれば、true に設定します。 (boolean)

  • type: 項目のタイプを示した文字列です。例 : home ( 自宅用 )(DOMString)

  • name: 組織名です。 (DOMString)

  • department: 所属する部署名です。 (DOMString)

  • title: 役職名です。 (DOMString)

サポート対象のプラットフォーム

  • Android

  • iOS

例

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        for (var j = 0; j < contacts[i].organizations.length; j++) {
            alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
                "Type: "        + contacts[i].organizations[j].type       + "\n" +
                "Name: "        + contacts[i].organizations[j].name       + "\n" +
                "Department: "  + contacts[i].organizations[j].department + "\n" +
                "Title: "       + contacts[i].organizations[j].title);
        }
    }
};

function onError(contactError) {
    alert('onError!');
};

var options = new ContactFindOptions();
options.filter = "";
options.multiple = true;
filter = ["displayName", "organizations"];
navigator.contacts.find(filter, onSuccess, onError, options);

Android 2.X 特有の動作

  • pref: Android 2.X 端末では使用できず、false を返します.

iOS 特有の動作

  • pref: iOS 端末では使用できず、false を返します。

  • type: iOS 端末では使用できず、null を返します。

  • name: 部分的に使用できます。最初の組織名は、iOS の

    kABPersonOrganizationProperty 項目に格納されます。

  • department: 部分的に使用できます。最初の部署名は、iOS の

    kABPersonDepartmentProperty 項目に格納されます。

  • title: 部分的に使用できます。1 つ目の役職は、iOS の

    kABPersonJobTitleProperty 項目に格納されます。

ContactFieldType

ContactFieldType オブジェクトは、「 項目 」 ( fieldType ) の集合体です。 たとえば、複数の phoneNumbers/電話番号 または emails/メールアドレス をまとめるときに使用します。また、このオブジェクトは、contacts.find() の使用時、検索対象の項目 ( contactFields を参照のこと ) として、または、検索結果として返される項目の指定 ( contactFindOptions.desiredFields を参照のこと ) に使用できます。

  • navigator.contacts.fieldType.addresses

  • navigator.contacts.fieldType.birthday

  • navigator.contacts.fieldType.categories

  • navigator.contacts.fieldType.country

  • navigator.contacts.fieldType.department

  • navigator.contacts.fieldType.displayName

  • navigator.contacts.fieldType.emails

  • navigator.contacts.fieldType.familyName

  • navigator.contacts.fieldType.formatted

  • navigator.contacts.fieldType.givenName

  • navigator.contacts.fieldType.honorificPrefix

  • navigator.contacts.fieldType.honorificSuffix

  • navigator.contacts.fieldType.id

  • navigator.contacts.fieldType.ims

  • navigator.contacts.fieldType.locality

  • navigator.contacts.fieldType.middleName

  • navigator.contacts.fieldType.name

  • navigator.contacts.fieldType.nickname

  • navigator.contacts.fieldType.note

  • navigator.contacts.fieldType.organizations

  • navigator.contacts.fieldType.phoneNumbers

  • navigator.contacts.fieldType.photos

  • navigator.contacts.fieldType.postalCode

  • navigator.contacts.fieldType.region

  • navigator.contacts.fieldType.streetAddress

  • navigator.contacts.fieldType.title

  • navigator.contacts.fieldType.urls

関連項目:

このプラグインを使用する場合には、Monaca クラウド IDE の [ Cordova プラグインの管理 ] 上で、Contacts プラグインをにします。

このプラグインは連絡先を選択するための外部アクティビティを起動します。 これがアプリに与える影響については、 を参照してください。 プラグインがその結果を resume イベントに返す場合、返されたオブジェクトをまず Contact オブジェクトでラップしてから使用する必要があります。 次に例を示します。

3.0.1
こちらの原文 ( GitHub )
プライバシーガイド
Android Lifecycle Guide
サードパーティー製プラグイン
基本プラグイン
有効